Commerce APIs
POST Orders
Commerce APIs
POST Orders
Purchase NFTs via credit card, ACH, or cryptocurrencies.
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
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"
}
}
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"
}'
{
"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"
}
}