Commerce APIs
POST Orders
POST

/v1/orders

Bearer*
curl --request POST \
  --url https://api.bitski.com/v1/orders \
  --header 'Bearer: <bearer>'
Access to this API is available upon request to sales@bitski.com.

The Orders API allows your users to purchase NFTs via credit card, ACH, or other cryptocurrencies. Card processors are customizable to fit your needs. No payment or fulfillment is completed on create order.

A payment intent is created and associated to the order to track sales that may not be completed.

curl -X 'POST' \
  'https://api.bitski.com/v1/orders' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -d '{
  "order": {
    "currency": "USD",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "items": [
      {
        "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "quantity": 0
      }
    ],
    "recipient": {
      "customerEmail": "john@example.com",
      "customerName": "John Doe",
      "destinationAddress": "0xa4ef984773fd233c4cbed9cb1b905a3fa21e9461"
    }
  },
  "payment": {
    "paymentMethodId": "pm_1Mz4es2eZvKYlo2CSnrUx5Z6"
  },
  "processorCustomerId": "cus_9s6XeO1kXqpwST"
}'

Examples

Example

Response

orderrequired
Order object
paymentrequired
Payment object
{
  "order": {
    "createdAt": "2023-04-20T21:05:20.976Z",
    "currency": "USD",
    "fees": "1.00",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "items": [
      {
        "amount": "10.00",
        "fees": "1.00",
        "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "taxes": "1.00"
      }
    ],
    "status": "DRAFT",
    "subtotal": "10.00",
    "taxes": "1.00",
    "total": "12.00"
  },
  "payment": {
    "createdAt": "2023-04-20T21:05:20.976Z",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "nextAction": null,
    "paymentMethodDescription": "Visa 4111",
    "paymentMethodId": "pm_1Mz4es2eZvKYlo2CSnrUx5Z6"
  }
}