Payout Query

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

EndPoint

POST /binancepay/openapi/payout/query

Request Parameters

Attributes	Type	Required	Limitation	Description
requestId	string	Y	Maximum length 32	The unique ID assigned by the merchant to identify a payout request.
detailStatus	list[string]	N	Enum string list	ALL: 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

Attributes	Type	Required	Limitation	Description
status	string	Y	"SUCCESS" or "FAIL"	status of the API request
code	string	Y	-	request result code, refer to
data	TransferQueryResult	N	-	response body, refer to
errorMessage	string	N	maximum length 256

Child Attribute

TransferQueryResult

Attributes	Type	Required	Limitation	Description
requestId	string	Y	Maximum length 32	The passed-in request ID
batchStatus	string	Y	Enum string	ACCEPTED: accepted the request, will process it soon. PROCESSING: batch under processing SUCCESS: all transfers are successful PART_SUCCESS: transfers partially succeeded FAILED: all transfers failed CANCELED: there remains transfers with unknown results after retry limit, will not retry further
merchantId	long	Y
currency	string	Y	Valid crypto currency	The request currency.
totalAmount	decimal	Y	limitation refer to Create Order API order amount	Total transfer amount in this batch.
totalNumber	int	Y	Maximum length 1000	Total number of transfers in the batch.
transferDetailList	TransferDetailResult	Y	Max size 1000	Detail transfer result.

Child Attribute

TransferDetailResult

Attributes	Type	Required	Limitation	Description
orderId	long	Y	Maximum length 32	The passed-in request ID.
merchantSendId	string	Y	Maximum length 32	The passed-in merchantSendId.
payerId	Long	Y		Payer's payment account ID.
amount	string	Y	limitation refer to Create Order API order amount	Amount transferred.
receiveType	string	Y	Enum string	PAY_ID BINANCE_ID
receiver	string	Y	Maximum length 19	Receiver ID from the request.
payeeId	long	Y		Receiver's payment account ID.
transferMethod	string	Y	Enum string	SPOT_WALLET FUNDING_WALLET
status	string	Y	Enum string	SUCCESS FAIL PROCESSING AWAITING_RECEIPT REFUNDED
remark	string	N		Maximum 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

Name	Code	Reason	Solution
UNKNOWN_ERROR	400000	An unknown error occurred while processing the request.	Try again later
INVALID_REQUEST	400001	Parameter format is wrong or parameter transferring doesn't follow the rules.	Please check whether the parameters are correct.
INVALID_SIGNATURE	400002	Incorrect signature result	Check whether the signature parameter and method comply with signature algorithm requirements.
INVALID_TIMESTAMP	400003	Timestamp for this request is outside of the time window.	Sync server clock
INVALID_API_KEY_OR_IP	400004	API identity key not found or invalid.	Check API identity key
BAD_API_KEY_FMT	400005	API identity key format invalid.	Check API identity key.
BAD_HTTP_METHOD	400006	Request method not supported.	Check Request method.
MEDIA_TYPE_NOT_SUPPORTED	400007	Media type not supported.	Check Request Media type.
INVALID_REQUEST_BODY	400008	Request body is not a valid json object.	Check Request body
MANDATORY_PARAM_EMPTY_OR_MALFORMED	400100	A parameter was missing/empty/null, or malformed.
INVALID_PARAM_WRONG_LENGTH	400101	A parameter was not valid, was empty/null, or too long/short, or wrong format.
INVALID_PARAM_WRONG_VALUE	400102	A parameter was not valid, the value is out of range.
INVALID_PARAM_ILLEGAL_CHAR	400103	A parameter was not valid, contains illegal characters
INVALID_REQUEST_TOO_LARGE	400104	Invalid request, content length too large
PAYMENT_PAY_ORDER_NOT_FOUND	400602	Pay order not found