# Commerce Endpoints and Transports


> Separate custom ForgeWP routes from WooCommerce Store API requests and identify current method and route mismatches.


# Commerce endpoints and transports

Custom routes live under `/wp-json/forgewp/v1`. WooCommerce's `/wp-json/wc/store/v1` is separate. The generated Auth write guard does not automatically protect the custom commerce routes.

| Custom route | Registered methods | Responsibility |
| --- | --- | --- |
| /products | GET | Catalog query |
| /products/{id}/reviews | GET, POST, DELETE | Review list and writes |
| /cart | GET | Current cart |
| /cart/add | POST | Add item |
| /cart/update | POST | Update quantity |
| /cart/remove | POST | Remove row |
| /cart/clear | POST | Empty cart |
| /cart/apply-coupon | POST | Coupon application |
| /cart/sync | POST | Synchronize item inputs |
| /cart/shipping-rates | POST | Shipping calculation |
| /checkout/gateways | GET | Gateway metadata |
| /checkout/process | POST | Custom order creation, not payment capture |
| /customer/orders | GET | Current customer's orders |
| /customer/orders/{id} | GET | Individual order lookup |
| /customer/downloads | GET | Current customer's downloads |
| /customer/profile | POST | Profile update |
| /customer/address | POST | Address update |
| /wishlist | GET | Wishlist lookup |
| /wishlist/toggle | POST | Toggle product |
| /wishlist/sync | POST | Wishlist synchronization |

These commerce registrations currently use public permission callbacks; handler-level checks differ. A complete permission, ownership, origin and rate review remains necessary. The route list is not evidence of private-data safety.

## Current client mismatches

Standalone cart clear selects GET, but its route accepts POST. Standalone coupon removal calls cart/remove-coupon, which the generator does not register. Provider clearCart clears local UI state rather than invoking a server clear operation. Resolve the implementation gaps rather than weakening server permissions.

## Store API helper

`fetchStoreApi(endpoint, options?)` calls wc/store/v1, sets JSON content type, includes credentials, sends a saved Store API Nonce and optional JWT, refreshes the saved nonce from response headers, and throws on unsuccessful HTTP responses. `mapStoreApiToCartState` maps the response into the provider's older state shape and converts currency minor units.

Store API `Nonce` values use `wc_store_api`; WordPress REST `X-WP-Nonce` values use `wp_rest`. They are distinct. Consult the official [nonce documentation](https://developer.woocommerce.com/docs/apis/store-api/nonce-tokens/) and [Store API contract](https://developer.woocommerce.com/docs/apis/store-api/). The helper alone does not establish first-request nonce bootstrap, session persistence or gateway compatibility.

---

Source: [Commerce Endpoints and Transports](https://www.forgewp.dev/docs/woocommerce/woo-reference/endpoints)
