Merchant cart
Complete checkout
Call after the buyer approved in PayPal. Sayso re-checks stock and price, authorizes the payment,
takes the stock and submits the capture to the shop's Guard. Big orders may wait for the owner:
then payment_status is AUTHORIZED_PENDING_MERCHANT_REVIEW and the buyer is charged only if the
owner agrees. Calling it again for a completed cart returns the same result; it never charges twice.
Path Parameters
slug*string
The shop, e.g. maya-ceramics
Length
length <= 80cartId*string
From createCart, e.g. cart_6dadca42ea7819f7
Length
length <= 60Request Body
application/json
items?array<>
Ignored; the stored cart is what gets paid.
payment_method*
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/shops/string/merchant-cart/string/checkout" \ -H "Content-Type: application/json" \ -d '{ "payment_method": { "type": "paypal", "token": "string" } }'{ "id": "string", "status": "CREATED", "validation_status": "VALID", "validation_issues": [ { "code": "INVENTORY_ISSUE", "type": "MISSING_FIELD", "message": "string", "user_message": "string", "variant_id": "string", "field": "string", "context": {}, "resolution_options": [ { "action": "REDUCE_QUANTITY", "label": "Buy 1 instead", "metadata": { "priority": 0, "auto_applicable": true, "cost_impact": { "currency_code": "USD", "value": "44.99" } } } ] } ], "items": [ { "variant_id": "var_mug_sage", "quantity": 1, "parent_id": "string", "name": "string", "description": "string", "price": { "currency_code": "USD", "value": "44.99" }, "selected_attributes": [ { "name": "string", "value": "string" } ] } ], "totals": { "subtotal": { "currency_code": "USD", "value": "44.99" }, "shipping": { "currency_code": "USD", "value": "44.99" }, "tax": { "currency_code": "USD", "value": "44.99" }, "discount": { "currency_code": "USD", "value": "44.99" }, "total": { "currency_code": "USD", "value": "44.99" } }, "available_shipping_options": [ { "id": "string", "name": "string", "price": { "currency_code": "USD", "value": "44.99" }, "is_selected": true, "description": "string", "estimated_delivery": "2019-08-24" } ], "customer": { "email_address": "string", "phone": "string", "name": { "given_name": "string", "surname": "string" } }, "shipping_address": { "address_line_1": "string", "address_line_2": "string", "admin_area_2": "string", "admin_area_1": "string", "postal_code": "string", "country_code": "string" }, "billing_address": { "address_line_1": "string", "address_line_2": "string", "admin_area_2": "string", "admin_area_1": "string", "postal_code": "string", "country_code": "string" }, "payment_method": { "type": "paypal", "token": "string", "payer_id": "string", "approval_url": "string" }, "payment_confirmation": { "merchant_order_number": "SAY-CSPMFQB9", "paypal_order_id": "string", "payment_status": "CAPTURED", "guard_record_id": "string" }}