Skip to main content
POST
Sets cart payment method

Path Parameters

cart_token
string
required
type
string
required

Payment method type. Core types: credit_card, affirm, bread, paypal, apple_pay, klarna. Platform-specific types follow the pattern {method}_{platform} (e.g. wechat_citcon, pix_dlocal, bancontact_ppro).

Query Parameters

jwt
string

JWT token for authenticated checkout

payment_method_id
integer

Saved payment method ID. When provided with a jwt query param, uses an existing saved payment method instead of creating a new one. The request body is not required in this flow.

Body

application/json
payment_method
object

Fields vary by payment type. Required per type: credit_card — token, token_provider, exp_month, exp_year; paypal — order_id (and optionally token); klarna — authorization_token, session_id; affirm, bread, apple_pay — token.

billing_address
object
use_customer_payment_method
boolean

When true, payment_method_id resolves against the customer's saved methods (via jwt). When false or omitted, it resolves against the fluid pay account.

payment_account
string | null

Payment account identifier

device_data
string | null

Braintree fraud detection fingerprint

Response

Payment method set successfully

card
object
required
meta
object | null