Skip to content
docs
ES
Carts & CheckoutCarts

Checkout cart

Creates the order group for the cart and returns its order IDs, payment state, and completed cart. A multi-seller cart can produce multiple orders.

POST/v1/carts/{cartToken}/checkout
No token

Path Parameters

cartToken*string

Token that identifies the cart.

Header Parameters

x-Store-Domain*string

Slug of the store or one of its configured domains, such as my-store.

Length1 <= length <= 253
X-Customer-Session?string

Customer session from POST /v1/customer/sessions. Links the cart to the customer, with their prices and assigned codes.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://storefront.ecomiq.pe/v1/carts/replace_with_the_issued_token/checkout" \  -H "x-Store-Domain: my-store" \  -H "X-Customer-Session: <session-id>" \  -H "Content-Type: application/json" \  -d '{    "paymentMethodCode": "POL-001",    "externalRef": "Mi tienda",    "receiptUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",    "token": "replace_with_the_issued_token",    "providerPaymentMethodId": "7204558912004328622",    "deviceSessionId": "7204558912004329776",    "campaignId": "7204558912004328792"  }'
{  "orderId": "7204558912004325350",  "orderNumber": "ORD-2026-0001",  "orderGroup": "ORD-2026-0001",  "orderIds": [    "7204558912004325350"  ],  "payment": {    "transactionId": "7204558912004323150",    "paymentMethodCode": "POL-001",    "providerId": "7204558912004329705",    "status": "pending",    "amount": 178,    "reference": "Frente al parque Kennedy.",    "actionKind": "none",    "receiptUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",    "action": {      "publicConfiguration": {        "key": "Mi tienda"      },      "url": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",      "html": "Mi tienda",      "clientSecret": "replace_with_a_random_secret",      "qrCode": "POL-001",      "expiresAt": "2026-09-28T15:30:00Z",      "voucherCode": "POL-001",      "qrImageUrl": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp"    }  },  "cart": {    "id": "7204558912004325176",    "token": "replace_with_the_issued_token",    "cartNumber": "C-04325176",    "email": "andrea.ramos@example.com",    "phone": "+51987654321",    "firstName": "Andrea",    "lastName": "Ramos",    "currencyCode": "PEN",    "status": "inProgress",    "completedAt": "2026-09-28T15:30:00Z",    "shippingAddress": {      "name": "Mi tienda",      "address1": "Av. Larco 1234",      "city": "Lima",      "countryCode": "PE",      "company": "Comercial Lima SAC",      "address2": "Dpto. 501",      "province": "Lima",      "postalCode": "15074",      "district": "Miraflores",      "phone": "+51987654321",      "latitude": 1,      "longitude": 1    },    "billingAddress": {      "name": "Mi tienda",      "address1": "Av. Larco 1234",      "city": "Lima",      "countryCode": "PE",      "company": "Comercial Lima SAC",      "address2": "Dpto. 501",      "province": "Lima",      "postalCode": "15074",      "district": "Miraflores",      "phone": "+51987654321",      "latitude": 1,      "longitude": 1    },    "promotionCodes": [      "BIENVENIDA10"    ],    "items": [      {        "id": "7204558912004325176",        "productId": "7204558912004322039",        "title": "Polo de algodón",        "variantLabel": "Mi tienda",        "productHandle": "polo-de-algodon",        "productUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",        "thumbnail": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",        "quantity": 2,        "variantId": "7204558912004323197",        "variantSku": "POL-001-AZ-M",        "unitPrice": 89,        "compareAtUnitPrice": 99,        "bundleItems": [          {            "productId": "7204558912004322039",            "variantId": "7204558912004323197",            "productName": "Polo de algodón",            "variantName": "Polo de algodón",            "sku": "POL-001-AZ-M",            "brand": "Andina",            "imageUrl": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",            "quantity": 2          }        ],        "requiresShipping": false,        "sellerId": "7204558912004323447",        "sellerName": "Polo de algodón",        "orderBumpId": "7204558912004327796",        "modifiers": [          {            "modifierGroupId": "7204558912004324624",            "modifierGroupName": "Personalización",            "modifierOptionId": "7204558912004327012",            "modifierOptionName": "Bordado",            "value": "Mi tienda",            "quantity": 2,            "priceDelta": 89          }        ]      }    ],    "shippingMethods": [      {        "id": "7204558912004325176",        "shippingMethodId": "7204558912004325207",        "rateId": "7204558912004322088",        "name": "Mi tienda",        "description": "Polo de algodón pima para uso diario.",        "type": "regular",        "target": "automatic",        "targetId": "7204558912004322457",        "fulfillmentLocationId": "7204558912004325563",        "total": 178,        "estimatedDays": 30,        "scheduledDate": "2026-09-28",        "scheduledTime": "09:00:00",        "serviceCode": "POL-001",        "sellerId": "7204558912004323447"      }    ],    "totals": {      "subtotal": 178,      "discountTotal": 178,      "shippingOriginalTotal": 178,      "shippingTotal": 178,      "taxTotal": 178,      "warrantyTotal": 178,      "total": 178    }  },  "orderStatusUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon"}