Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sp3ndpay.shop/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST /v1/orders

​
Request

curl -X POST https://api.sp3ndpay.shop/v1/orders \
  -H "Authorization: Bearer sp3ndpay_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "cart_id": "cart_7K2pQ9xM",
    "customer_email": "customer@example.com",
    "payment_asset": "USDC",
    "shipping_address": {
      "name": "Alex Johnson",
      "phone": "+1 555 123 4567",
      "line1": "123 Market St",
      "city": "New York",
      "region": "NY",
      "postal_code": "10001",
      "country": "US"
    }
  }'

​
Parameters

ParameterTypeRequired
cart_idstringYes
customer_emailstringYes
payment_assetstringYes
shipping_addressobjectYes

​
Response

{
  "order": {
    "id": "ord_8nJ42rA",
    "number": "SP3ND-184920",
    "status": "created",
    "total": 109.27,
    "payment_asset": "USDC",
    "payment_amount": "109.27",
    "payment_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "payment_memo": "SP3ND-184920",
    "payment_expires_at": "2026-05-04T18:45:00Z",
    "tracking_url": "https://sp3ndpay.shop/track?order=SP3ND-184920"
  }
}

​
Payment Instructions

User must:
  1. Send payment_amount of payment_asset to payment_address
  2. Include payment_memo in transaction
  3. Complete before payment_expires_at
Payment memo is required to match transaction to order.

​
Order Status

Created → Paid → Ordered → Shipped → Delivered

​
Errors

Cart Not Found: 
{
  "error": {
    "code": "cart_not_found",
    "message": "Cart does not exist or expired"
  }
}
Invalid Address: 
{
  "error": {
    "code": "invalid_address",
    "message": "Shipping address invalid or incomplete"
  }
}

Get Order

Next: Track order