Create payment & make payout via API Reference

Payment and payout creation via the API Reference is the fastest way to test the Bitnbox platform. Here's a guide on how to do that.

You can find the currencies and network codes in the API Glossary.

Make free transactions on test networks — guide.

Payment

1. Create a payment

1. Go to the API Reference page

2. Click on “Test it”

3. Insert your API Key in the “x-api-key” field

4. Fill in the required invoice properties

   { // example
     "amount": 123, // min 5.00
     "method": "direct", // direct on-chain transfer
     "customerId": "<string>", // payer IP
     "customerIp": "<string>",// payer IP
     "orderId": "<string>",// any input
     "orderDescription": "<string>", // any input
     "additionalData": "<string>",// any input
     "platformFeeByUser": false, // who pays the processing fee
     "currency": "usdt", // we recommend using USDT for test payments
     "network": "sepolia" // we recommend using Sepolia or Amoy for test payments
     "webhookUrl": "", // URL for webhook
     "cancelUrl": "<string(256]>", // URL to redirect to when payment is failed for Binance Pay, KuCoin Pay. must begin with HTTP. optional 
     "successUrl": "<string(256]>", // URL to redirect to when payment is success for KuCoin Pay. must begin with HTTP. optional
   }

5. Click on “Send”

6. Get the payment address

   { // example
     "orderId": "1",
     "status": "waiting",
     "method": "direct",
     "currency": "usdt",
     "network": "sepolia",
     "payAmount": 123,
     "paymentId": "11bf97b6-9b27-1b21-9177-ec1e1581219c",
     "checkoutUrl": "http://pay.bitnbox.io?paymentId=11bf97b6-9b27-1b21-9177-ec1e1581219c",
     "payAddress": "0xaf38220a2f436bc6bd3b5a7cb67afc4dfb47f7ae",
     "payQrCodeUri": "data:image/png;base64,iVBOR...ggg==",
     "customerId": "1/213-3",
     "customerIp": "10.70.43.129",
     "processingFeeByUser": false,
     "additionalData": "test",
     "webhookUrl": "https://slimy-rainbow-62.webhook.cool",
     "createdAt": "2025-03-20T14:27:24.155Z",
     "updatedAt": "2025-06-30T14:27:24.155Z",
     "expiredAt": "2025-06-30T20:27:24.154Z",
   }

After this, you can send the crypto to the payment address.

2. Get payment status

1. Go to the API Reference page

2. Scroll down to the “Get payment status by ID” section

3. Click on the “Test it” button

4. Insert your API Key in the “x-api-key” field

5. Type the payment ID

6. Click on “Send”

7. Get the payment status

Also, you can see the payment status on the Transaction History page in the web app.

Payout

1.1. Create a payout via API

1. Go to the API Reference page

2. Click on “Test it”

3. Insert your API Key in the “x-api-key” field

4. Fill in the required payout properties

   {
     "method": "direct" or "binancePay"
     "amount": 50
     "currency": "usdt", // any available currency
     "orderId": "<string>",// any input
     "customerId": "<string>"
     "customerIp": "<string>"
     "networkFeeByUser": false
     "network": "sepolia"
     "walletAddress": "<string>" // recipient's wallet address
   }

5. Click on “Send”

6. You will also see the payout status in the app

1.2. Create a payout via the App

1. Go to the payout page - New Payout

2. Fill out the required properties

3. Click on "Transfer"

2. Get payout status

1. Go to the API Reference page

2. Scroll down

3. Click on the “Test it” button

4. Insert your API Key in the “x-api-key” field

5. Type the payout ID

6. Click on “Send”

7. Get the payout status

Also, you can see the payout status on the Transaction History page in the web app.