Skip to main content
POST
https://api.stateset.network
/
v1
/
order
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"
    }
}'

{
  "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"
  }
}

​
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
​
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.
​
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

​
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 --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"
    }
}'

{
  "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"
  }
}