Skip to main content

Payout Query

Payout query API used for Merchant/Partner to query transfer status.

EndPoint

POST /binancepay/openapi/payout/query

Request Parameters

AttributesTypeRequiredLimitationDescription
requestIdstringYMaximum length 32The unique ID assigned by the merchant to identify a payout request.
detailStatuslist[string]NEnum string listALL: return all transfer details, default value.
PROCESSING: only return transfers in processing.
SUCCESS: only return successful transfers.
FAIL: only return failed transfers.

Sample Request Body

{
"requestId":"payouttransfer19998"
}

Response Parameters

AttributesTypeRequiredLimitationDescription
statusstringY"SUCCESS" or "FAIL"status of the API request
codestringY-request result code, refer to
dataTransferQueryResultN-response body, refer to
errorMessagestringNmaximum length 256

Child Attribute

TransferQueryResult

AttributesTypeRequiredLimitationDescription
requestIdstringYMaximum length 32The passed-in request ID
batchStatusstringYEnum stringACCEPTED: accepted the request, will process it soon.
PROCESSING: batch under processing
SUCCESS: All payout performed successfully, user have received fund in Binance funding wallet
PART_SUCCESS: transfers partially succeeded.
Reasons:
1.Insufficient funds: there’s insufficient fund in your account
2.Awaiting recipient: pending user to create Binance account and perform KYC
3.Partial refund: user failed to complete KYC in 72 hours, fund will be funded to merchant account
FAILED: all transfers failed
CANCELED: Transfer request canceled by Binance due to unknown system errors after retry limit, will not retry further
merchantIdlongY
currencystringYValid crypto currencyThe request currency.
totalAmountdecimalYlimitation refer to Create Order API order amountTotal transfer amount in this batch.
totalNumberintYMaximum length 1000Total number of transfers in the batch.
transferDetailListTransferDetailResultYMax size 1000Detail transfer result.

Child Attribute

TransferDetailResult

AttributesTypeRequiredLimitationDescription
orderIdlongYMaximum length 32The passed-in request ID.
merchantSendIdstringYMaximum length 32The passed-in merchantSendId.
payerIdLongYPayer's payment account ID.
amountstringYlimitation refer to Create Order API order amountAmount transferred.
receiveTypestringYEnum stringPAY_ID
BINANCE_ID
receiverstringYMaximum length 19Receiver ID from the request.
payeeIdlongYReceiver's payment account ID.
transferMethodstringYEnum stringSPOT_WALLET
FUNDING_WALLET
statusstringYEnum stringSUCCESS: money has been transferred successfully
FAIL:transaction failed may case by there’s insufficient fund in your account
AWAITING_RECEIPT pending new user create an binance account and pass KYC to receive money
REFUNDED: new user hasn’t pass KYC in 72 hours
remarkstringNMaximum length 128

Sample Response

{
"status": "SUCCESS",
"code": "000000",
"data": {
"requestId": "payoutqueryrequest1232455",
"batchStatus": "ACCEPTED",
"merchantId": 354195960,
"currency": "USDT",
"totalAmount": "0.00000002",
"totalNumber": 2,
"transferDetailList": [
{
"orderId": 118073402258677761,
"merchantSendId": "21231313131",
"payerId": 354195960,
"amount": "0.00000001",
"receiveType": "PAY_ID",
"receiver": "354205155",
"payeeId": 354205155,
"transferMethod": "SPOT_WALLET",
"status": "PROCESSING",
"remark": "test1"
},
{
"orderId": 118073402258677762,
"merchantSendId": "21231313132",
"payerId": 354195960,
"amount": "0.00000001",
"receiveType": "PAY_ID",
"receiver": "354205155",
"payeeId": 354205155,
"transferMethod": "SPOT_WALLET",
"status": "PROCESSING",
"remark": "test2"
}
]
}
}

{
"status": "FAIL",
"code": "403015",
"errorMessage": "pay order not found"
}

Result Code

NameCodeReasonSolution
UNKNOWN_ERROR400000An unknown error occurred while processing the request.Try again later
INVALID_REQUEST400001Parameter format is wrong or parameter transferring doesn't follow the rules.Please check whether the parameters are correct.
INVALID_SIGNATURE400002Incorrect signature resultCheck whether the signature parameter and method comply with signature algorithm requirements.
INVALID_TIMESTAMP400003Timestamp for this request is outside of the time window.Sync server clock
INVALID_API_KEY_OR_IP400004API identity key not found or invalid.Check API identity key
BAD_API_KEY_FMT400005API identity key format invalid.Check API identity key.
BAD_HTTP_METHOD400006Request method not supported.Check Request method.
MEDIA_TYPE_NOT_SUPPORTED400007Media type not supported.Check Request Media type.
INVALID_REQUEST_BODY400008Request body is not a valid json object.Check Request body
MANDATORY_PARAM_EMPTY_OR_MALFORMED400100A parameter was missing/empty/null, or malformed.
INVALID_PARAM_WRONG_LENGTH400101A parameter was not valid, was empty/null, or too long/short, or wrong format.
INVALID_PARAM_WRONG_VALUE400102A parameter was not valid, the value is out of range.
INVALID_PARAM_ILLEGAL_CHAR400103A parameter was not valid, contains illegal characters
INVALID_REQUEST_TOO_LARGE400104Invalid request, content length too large
PAYMENT_PAY_ORDER_NOT_FOUND400602Pay order not found