Skip to content

Payout request ByBitPay in USDT

The request contains certain fields:

Field Description
merchant unique merchant ID;
method payout method, integer number:
94 – Payout ByBitPay USDT;
payout_id the number of the outgoing payment in the merchant’s system;
account UID (Bybit UID), a unique numeric identifier of the user. It can be 1–12 digits long;
amount amount of the transaction in currency, separator character is a period “.”;
currency transaction currency “USD”;
sign digital signature with the merchant’s key. Available fields are: merchant, method, payout_id, account, amount, currency. Hashed using the MD5 method (for more details read the “Digital signature in requests” section);
POST /merchant/api/payout_send 
https://<provided_url>
/merchant/api/payout_send

Example of the request:

Example of the request

application/json

{
    "merchant" : "M1VJDHSI6DYXS",
    "method" : 94,
    "payout_id" : "000002",
    "account" : "111111112222",
    "amount" : "102.81",
    "currency" : "USD",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

The response contains the fields:

Field Description
status transaction status:
Success – the payment was made successfully (the status is final)
Pending – the payment is new or is in the line for processing. The Pending status requires an additional request (for more details read the “Payment Status Request (payment)” section).
Blocked – payment rejected (final status)
Error – received data error. The response contains a signature with an empty key (the status is not final and is the basis for finding out the reason of this status);
code transaction status code;
payout_id the number of the outgoing payment in the merchant’s system;
description status description;
sign digital signature with the merchant’s key;

An example of a response is a Success status:

Example of the response

application/json

{
    "status" : "Success",
    "code" : "0",
    "payout_id" : 000002,
    "description" : "Payment successful. Status final",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

An example of a response is the Pending status:

Example of the response

application/json

{
    "status" : "Pending",
    "code" : "40",
    "payout_id" : 000002,
    "description" : "Payment in order",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

An example of a response is the Error status:

Example of the response

application/json

{
    "status" : "Error",
    "code" : "99",
    "payout_id" : "",
    "description" : "Sign error",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

Final Status (Callback)

To notify the merchant that the transaction has received the final status (for example, from “Pending” to “Success”), the callback mechanism is used.

For more information read the Callbacks section.