Commerce APIs
POST Orders
Purchase NFTs via credit card, ACH, or cryptocurrencies.
POST
/
v1
/
orders
Authorization
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"
}
}
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.
Examples
Response
order
Order object
requiredpayment
Payment object
requiredcurl -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"
}
}