Validating recipient's Binance ID

POST /api/public/v1/payouts/binance_receiver/validate

Verifies that a recipient's Binance ID is recognised by Binance before you create a binance_pay payout. A 200 response confirms the ID is valid and the recipient can receive Binance Pay payments. Call this endpoint before Create Payout to catch invalid IDs early.

This endpoint uses Content-Type: application/json, not application/vnd.api+json.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <api_key>

Request Body

Name	Type	Required	Description
receiver_id	string	Yes	Recipient's Binance ID. Must be numeric, 7 or more digits.

cURL

curl -X "POST" "https://api.sandbox.txn.io/api/public/v1/payouts/binance_receiver/validate" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <api_key>' \
     -d '{
  "receiver_id": "474748434"
}'

Response

HTTP 200

{
  "data": {},
  "status": "ok",
  "jsonapi": {
    "version": "1.0"
  }
}

Binance ID is recognised. Safe to use as receiverBinanceId in a Create Payout request.

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "Invalid receiver",
      "code": "binance_pay_invalid_receiver",
      "detail": "The provided Binance ID is not valid."
    }
  ]
}

The Binance ID is not recognised or the format is invalid. Do not proceed with a binance_pay payout to this ID.