PeptidesPayment Docs
Payment ContainerCarts

Create a cart from a custom storefront payload

POST/carts/from-api

Creates a cart from a fully computed payload for a custom storefront (not Shopify or WooCommerce). All monetary values must be sent as integer minor units (cents for 2-decimal currencies, fils for KWD, BHD, OMR, JOD, and TND). See the Custom store guide for the full field contract.

Authorization

ApiKeyAuth
x-api-key<token>

Your API key, issued by PeptidesPayment. Send it in the x-api-key header. Keep it server-side and never expose it in browser code.

In: header

Header Parameters

x-merchant-id*string

Your merchant id, supplied by PeptidesPayment at integration time.

Request Body

application/json

Request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/carts/from-api" \  -H "x-merchant-id: string" \  -H "Content-Type: application/json" \  -d '{    "external_cart_id": "cart-abc-123",    "currency": "AED",    "customer_country_code": "AE",    "email": "shopper@example.com",    "items": [      {        "external_product_id": "prod-001",        "external_variant_id": "var-001",        "sku": "TEST-SKU-001",        "title": "Premium Espresso Beans",        "quantity": 1,        "unit_price": 15000,        "weight_grams": 250,        "requires_shipping": true      }    ],    "shipping_address": {      "first_name": "Jane",      "last_name": "Doe",      "address_1": "1 Sheikh Zayed Rd",      "address_2": "Apt 1203",      "city": "Dubai",      "province": "Dubai",      "postal_code": "00000",      "country_code": "AE",      "phone": "+971501234567"    },    "billing_address": {      "first_name": "Jane",      "last_name": "Doe",      "address_1": "1 Sheikh Zayed Rd",      "city": "Dubai",      "country_code": "AE",      "phone": "+971501234567"    }  }'
{  "success": true,  "medusa_cart": {    "id": "string"  },  "source_platform": "custom_api",  "external_cart_id": "string"}

Disputes and refunds

PeptidesPayment fights chargebacks on your behalf. Here is the part you help with, and how refunds work.

Create a cart from a Shopify cart token POST

Creates a cart from a Shopify cart token. This is the primary endpoint called on checkout page load, and it skips re-syncing when the cart is unchanged.