Create Binance Pay Invoice

Creates invoice that enables customers to deposit payments through Binance Pay.

Body Params

Data fields for an Individual Payer associated with PPDL (Gibraltar), including data required for Travel Rule compliance.

string
required

Unique ID for the transaction generated by the merchant. Each request requires a new externalId; reusing one is not allowed.

string
required

The cryptocurrency to be transferred by the payer.

Accepted: USDT or USDC

string

The amount of cryptocurrency being sent.

string

The fiat currency in which the merchant will be credited.

Accepted: USD, GBP, EUR.

  • If targetCurrency is set, a crypto-fiat conversion occurs.
  • If omitted, no conversion occurs, and the deposit is made in the cryptocurrency specified in the currency field.
string

Amount in targetCurrency that the merchant will receive after conversion.

string
enum

The currency in which the payer's balance is displayed on the merchant platform.

string

Amount in cashierCurrency that is reflected on the payer's balance in the merchant platform.

string

Merchant webhook URL to receive payment notifications.

string

Payer's Binance ID. (Required if Binance Pay Validation feature flag is enabled).

string
required
length ≤ 100

Payer's first name.

string
required
length ≤ 100

Payer's last name.

string
required

Payer's date of birth (YYYY-MM-DD).

string
length ≤ 16

Postal code of the payer's address.

string
length ≤ 35

Town of the payer's address.

string
enum
required

The four types of identification used for payer verification: personalDocument, placeOfBirth, fullAddress, and customerId.

Allowed:
string
length ≤ 70

Payer's place of birth.

Required if identificationType is placeOfBirth.

string

The country where the payer's resides (ISO-3166-1 alpha-2).

Required if identificationType is fullAddress.

string
length ≤ 70

Street name of the payer's address.

Required if identificationType is fullAddress.

string
length ≤ 16

Building number of the payer's address.

Required if identificationType is fullAddress.

string
length ≤ 35

Identification document number.

Required if identificationType is personalDocument.

string
enum

Identification document.

Required if identificationType is personalDocument.

string

The country that issued the identification document (ISO-3166-1 alpha-2 code).

Required if identificationType is personalDocument.

string
length ≤ 50

The internal ID for the payer.

Required if identificationType is customerId.

string
Defaults to naturalPerson

Indicates the type of payer. Can be naturalPerson or legalPerson.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json