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, unsupported recurring Apple Pay, or a Fastlane or Apple Pay
order with no expected_total while the quote-failure policy is enabled; 404 when the cart is
not found; and 410 when the cart has already been processed or holds an authorized enrollment.
curl --request POST \
--url https://api.fluid.app/api/payments/v2026-04/carts/{cart_token}/paypal/orders \
--header 'Content-Type: application/json' \
--data '
{
"funding_source": "paypal",
"is_pay_later": false
}
'{
"success": true,
"order_id": "5O190127TN364715T",
"meta": {
"request_id": "018f2c1a-8b3a-7e6d-9f10-2a3b4c5d6e7f",
"timestamp": "2026-04-01T12:00:00Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "payment_in_progress",
"shop_url": "<string>",
"cart": {}
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {}
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}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
PayPal funding source (e.g. paypal, Venmo, apple_pay).
Fastlane single-use payment token; presence switches the order to the Fastlane capture flow.
The cart total the client showed the shopper, as a decimal string in
the cart currency's major unit ("141.74"). Requires
expected_currency.
Required for a Fastlane or Apple Pay order (charged at create) while the company's quote-failure policy is enabled:
omitting it, or sending it malformed, answers 422 with an
expected_total or expected_currency error before the cart is repriced and before any
provider call. When it no longer matches the cart, the response is
409 with meta.code = cart_total_changed and nothing is charged;
retry with the total in meta.cart. Optional, and ignored, otherwise.
^\d{1,12}(\.\d{1,5})?$"141.74"
ISO 4217 code of the currency the shopper was shown. Requires expected_total.
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.
Show child attributes
Show child attributes
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.
curl --request POST \
--url https://api.fluid.app/api/payments/v2026-04/carts/{cart_token}/paypal/orders \
--header 'Content-Type: application/json' \
--data '
{
"funding_source": "paypal",
"is_pay_later": false
}
'{
"success": true,
"order_id": "5O190127TN364715T",
"meta": {
"request_id": "018f2c1a-8b3a-7e6d-9f10-2a3b4c5d6e7f",
"timestamp": "2026-04-01T12:00:00Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "payment_in_progress",
"shop_url": "<string>",
"cart": {}
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {}
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}