curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/carts/{id}/payment' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"billing_address": {
"city": "San Francisco",
"company": "Acme Outdoors",
"country": "US",
"email": "ada.lovelace@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"line1": "548 Market St",
"line2": "Suite 400",
"phone": "+1 415 555 0142",
"postal_code": "94107",
"state": "CA"
},
"payment_method": "card",
"payment_token": "YOUR_API_KEY"
}'
{
"cart_number": "string",
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"customer_email": "ada.lovelace@example.com",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"discount_amount": "5.00",
"grand_total": "102.12",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"items": [
{
"discount_amount": "5.00",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"sku": "SKU-TENT-2P-GRN",
"total": "102.12",
"unit_price": "49.00"
}
],
"order_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_number": "ORD-10042",
"payment_method": "card",
"shipping_amount": "8.00",
"shipping_method": "ground",
"status": "pending",
"subtotal": "98.00",
"tax_amount": "4.12"
}
Set payment
Set payment
POST
/
api
/
v1
/
carts
/
{id}
/
payment
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/carts/{id}/payment' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"billing_address": {
"city": "San Francisco",
"company": "Acme Outdoors",
"country": "US",
"email": "ada.lovelace@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"line1": "548 Market St",
"line2": "Suite 400",
"phone": "+1 415 555 0142",
"postal_code": "94107",
"state": "CA"
},
"payment_method": "card",
"payment_token": "YOUR_API_KEY"
}'
{
"cart_number": "string",
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"customer_email": "ada.lovelace@example.com",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"discount_amount": "5.00",
"grand_total": "102.12",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"items": [
{
"discount_amount": "5.00",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"sku": "SKU-TENT-2P-GRN",
"total": "102.12",
"unit_price": "49.00"
}
],
"order_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_number": "ORD-10042",
"payment_method": "card",
"shipping_amount": "8.00",
"shipping_method": "ground",
"status": "pending",
"subtotal": "98.00",
"tax_amount": "4.12"
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
Path parameters
string
required
Cart ID
Request body
SetCartPaymentRequest
CartAddressRequest,null
string
required
string,null
Response
CartResponse
string
required
string
required
string
required
string,null
string,null
string
required
string
required
string
required
CartItemResponse[]
required
string,null
string,null
string,null
string
required
string,null
string
required
string
required
string
required
Status codes
| Code | Meaning |
|---|---|
200 | — |
400 | — |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/carts/{id}/payment' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"billing_address": {
"city": "San Francisco",
"company": "Acme Outdoors",
"country": "US",
"email": "ada.lovelace@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"line1": "548 Market St",
"line2": "Suite 400",
"phone": "+1 415 555 0142",
"postal_code": "94107",
"state": "CA"
},
"payment_method": "card",
"payment_token": "YOUR_API_KEY"
}'
{
"cart_number": "string",
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"customer_email": "ada.lovelace@example.com",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"discount_amount": "5.00",
"grand_total": "102.12",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"items": [
{
"discount_amount": "5.00",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"sku": "SKU-TENT-2P-GRN",
"total": "102.12",
"unit_price": "49.00"
}
],
"order_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_number": "ORD-10042",
"payment_method": "card",
"shipping_amount": "8.00",
"shipping_method": "ground",
"status": "pending",
"subtotal": "98.00",
"tax_amount": "4.12"
}
Last modified on September 21, 2026