Payout

Create payout.

post

Creates a payout by specifying the wallet address, amount, currency, network, customer details, and an optional webhook URL for notifications. This endpoint initiates the process of transferring funds to the user's specified wallet.

Authorizations
Body

Withdrawal creation request body.

methodstring · enumOptional

A method to make a payout (e.g., to a web3 wallet, or Binance Account).

Default: directPossible values:
binanceIdstring · min: 1Optional

Recipient's Binance Pay ID or Binance Email. If the payout method is Binance Pay, this field is required.

walletAddressstringOptional

Recipient's wallet address.

networkFeeByUserbooleanRequired

Specifies whether the network fee should be deducted from the amount being withdrawn (true) or the remaining balance (false). Choose the latter option if you need to send a specific amount.

amountnumberRequired

Amount to withdraw.

currencystring · min: 1Required

Currency for withdrawal, specified via tickers (refer to API glossary).

networkanyRequired

Blockchain network for withdrawal, specified via tickers (refer to API glossary).

customerIdstring · min: 1Required

Customer's ID for security purposes.

customerIpstring · min: 1Required

Customer's IP address for security purposes.

orderIdstring · min: 1Required

Customer's order ID.

additionalDatastringOptional

Additional information related to the payout, if needed.

webhookUrlstringOptional

Webhook address for receiving withdrawal notifications.

Responses
201

201

application/json
post
POST /v1/payout HTTP/1.1
Host: api.bitnbox.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 230

{
  "method": "direct",
  "binanceId": "text",
  "walletAddress": "text",
  "networkFeeByUser": true,
  "amount": 1,
  "currency": "text",
  "network": null,
  "customerId": "text",
  "customerIp": "text",
  "orderId": "text",
  "additionalData": "text",
  "webhookUrl": "text"
}
{
  "method": "direct",
  "payoutId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "created",
  "amount": 1,
  "walletAddress": "text",
  "binanceId": "text",
  "networkFeeByUser": true,
  "currency": "text",
  "network": "text",
  "customerId": "text",
  "customerIp": "text",
  "orderId": "text",
  "additionalData": "text",
  "webhookUrl": "https://example.com",
  "createdAt": "2025-09-10T05:12:51.231Z",
  "updatedAt": "2025-09-10T05:12:51.231Z"
}
get
Authorizations
Path parameters
idstring · uuidRequired

Unique identifier of the withdrawal

Responses
200

200

application/json
get
GET /v1/payout/{id}/status HTTP/1.1
Host: api.bitnbox.io
x-api-key: YOUR_API_KEY
Accept: */*
{
  "method": "direct",
  "payoutId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "created",
  "amount": 1,
  "walletAddress": "text",
  "binanceId": "text",
  "networkFeeByUser": true,
  "currency": "text",
  "network": "text",
  "customerId": "text",
  "customerIp": "text",
  "orderId": "text",
  "additionalData": "text",
  "webhookUrl": "https://example.com",
  "createdAt": "2025-09-10T05:12:51.231Z",
  "updatedAt": "2025-09-10T05:12:51.231Z",
  "paidAmount": 1,
  "merchantAmount": 1
}

Last updated