Create a PayPal order
Creates a PayPal order for the cart and returns its order_id for the
client SDK to approve. Supplying payment_token_id switches the request to
the Fastlane capture flow, which additionally returns authorization_id and
a payment_uuid — the Fluid payment reference carried into the Cart checkout
complete_cart step (POST /api/checkout/v2026-04/carts/{cart_token}/complete,
Checkout endpoints reference) as its payment_uuid query parameter.
Cart-token authenticated. Returns 422 for invalid parameters, a
zero-amount cart, or unsupported recurring Apple Pay; 404 when the cart is
not found; and 410 when the cart has already been processed or holds an authorized enrollment.
Path Parameters
Opaque cart token returned by the create-cart response. It scopes the request to a single cart and is the credential for these endpoints — cart-token authentication carried in the path, with no bearer token or API key.
Body
Response
Order created
Success body for PayPal order creation. authorization_id and payment_uuid are present only for Fastlane orders (when payment_token_id is supplied).
true when the PayPal order was created.
PayPal order id; pass it to the client SDK to approve, then to the authorize endpoint. null when PayPal rejected the order — treat a 201 with a null order id as a failure.
Standard response metadata included on every response.
PayPal capture id (Fastlane orders only).
Fluid payment reference (slug), returned for Fastlane orders only. This is the reference the Cart checkout complete_cart step (POST /api/checkout/v2026-04/carts/{cart_token}/complete, Checkout endpoints reference) consumes as its payment_uuid query parameter.