Skip to main content
GET
/
v1
/
payout
/
{id}
/
status
cURL
curl --request GET \
  --url https://api.bitnbox.io/v1/payout/{id}/status \
  --header 'x-api-key: <api-key>'
{
  "payoutId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "created",
  "amount": 123,
  "walletAddress": "<string>",
  "networkFeeByUser": true,
  "currency": "<string>",
  "network": "<string>",
  "customerId": "<string>",
  "customerIp": "<string>",
  "orderId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "paidAmount": 123,
  "merchantAmount": 123,
  "additionalData": "<string>",
  "webhookUrl": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string<uuid>
required

Unique identifier of the withdrawal

Response

200

Successful response with withdrawal status details

​
payoutId
string<uuid>
required

Payout ID

​
status
enum<string>
required

Payout status

Available options:
created,
review,
processing,
confirming,
paid,
failed,
cancelled
​
amount
number
required

The requested amount for payout

​
walletAddress
string
required

The address to which payout was made

​
networkFeeByUser
boolean
required

Who paid the blockchain fee, merchant or end user

​
currency
string
required

The currency key: usdt, eth, usdc, etc

​
network
string
required

The network key: eth, sepolia, tron, etc

​
customerId
string
required

The end user ID, set by the merchant

​
customerIp
string
required

The IP address of the end user, set by the merchant

​
orderId
string
required

The order ID for the withdrawal, set by the merchant

​
createdAt
string<date-time>
required

Date of creation

​
updatedAt
string<date-time>
required

Date of update

​
paidAmount
number
required

Amount paid

​
merchantAmount
number
required

Amount of money was withdrawn from merchant

​
additionalData
string

Additional information, optional, set by the merchant

​
webhookUrl
string<uri>

The URL to which events for this withdrawal request will be sent