Create Order

This endpoint creates a new order.

Body

id · string

This is the ID of the order to be created.

name · string

This is the name of the order.

number · string

This is the number of the order.

source · string · required

This is the source of the order.

customerID · string

This is the ID of the customer who placed the order.

items · array

This is the list of items in the order.

totalAmount · object

The total amount of the order

Show properties

value · string · required

The numeric amount (e.g., “150.00”)

denom · string · required

The denomination: “ssusd” (default), “usdc” (legacy), or “usd”

paymentStatus · string

This is the payment status of the order. Options: “unpaid”, “pending”, “paid”, “partially_paid”, “failed”

paymentMethod · object

The preferred payment method for this order.

Show properties

type · string

Payment method type. Options: “ssusd” (default), “usdc” (legacy), “card”, “bank_transfer”

wallet_address · string

Customer’s wallet address for stablecoin payments

chain · string

Preferred blockchain: “stateset” (default), “base”, “solana”, “cosmos”

shippingStatus · string

This is the shipping status of the order.

metadata · object

This is additional metadata related to the order.

Response

success · number

Indicates whether the call was successful. 1 if successful, 0 if not.

order · object

The created order object

Show properties

id · string

Unique order identifier

totalAmount · object

Order total with denomination

paymentMethod · object

Configured payment method

status · string

Order status

Notes

• Orders are created with paymentStatus: "unpaid" by default
• To pay for an order after creation, use the Pay Order endpoint
• All monetary amounts should be specified in USDC
• StateSet Commerce Network uses native USDC - no bridging required

cURL

curl --location --request POST 'https://api.stateset.network/v1/order' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "name": "Premium Subscription Order",
    "number": "ORD-2024-001",
    "source": "web_checkout",
    "customerID": "cust_123456",
    "items": [
        {
            "product_id": "prod_premium_annual",
            "quantity": 1,
            "price": "150.00",
            "name": "Premium Annual Subscription"
        }
    ],
    "totalAmount": {
        "value": "150.00",
        "denom": "ssusd"
    },
    "paymentStatus": "unpaid",
    "paymentMethod": {
        "type": "ssusd",
        "wallet_address": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
        "chain": "stateset"
    }
}'

Response

{
  "success": 1,
  "order": {
    "id": "order_1a2b3c4d5e6f",
    "name": "Premium Subscription Order",
    "number": "ORD-2024-001",
    "source": "web_checkout",
    "customerID": "cust_123456",
    "items": [
      {
        "product_id": "prod_premium_annual",
        "quantity": 1,
        "price": "150.00",
        "name": "Premium Annual Subscription"
      }
    ],
    "totalAmount": {
      "value": "150.00",
      "denom": "ssusd"
    },
    "paymentStatus": "unpaid",
    "paymentMethod": {
      "type": "ssusd",
      "wallet_address": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
      "chain": "stateset"
    },
    "status": "pending",
    "created_at": "2024-01-15T12:00:00Z"
  }
}