Carts & CheckoutCarts
Set cart payment method
Selects one of the store's active checkout payment methods for the cart and recalculates its discounts.
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.
Length
1 <= length <= 253X-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 PUT "https://storefront.ecomiq.pe/v1/carts/replace_with_the_issued_token/payment-method" \ -H "x-Store-Domain: my-store" \ -H "X-Customer-Session: <session-id>" \ -H "Content-Type: application/json" \ -d '{ "paymentMethodCode": "POL-001" }'{ "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 }}