Commerce APIs
POST Orders
- Documentation
- Introduction
- Overview
- Quickstart
- Errors
- Pagination
Wallet Creation APIs
Wallet Experience APIs
NFT APIs
Web3 APIs
SDK
Overview
Wallet as a Service (WaaS)
Commerce APIs
POST Orders
Purchase NFTs via credit card, ACH, or cryptocurrencies.
POST
/
v1
/
orders
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
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
requiredid
string
requiredcreatedAt
string
requiredcurrency
string
requireditems
array
requiredstatus
string
requiredsubtotal
string
requiredfees
string
requiredtaxes
string
requiredtotal
string
requiredpayment
Payment object
requiredid
string
requiredcreatedAt
string
requirednextAction
object
paymentMethodDescription
object
requiredpaymentMethodId
string
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"
}
}