Crypto Payments

Validate address

Validates that a crypto address is correct.

Use this endpoint to validate that an address exists, is correctly formatted, and includes all the required data. This endpoint can help prevent your end users losing funds when submitting a payout.

put/api/v1/pay/validate

Request

Request body

codestring required

Gateway to be used. Currently, only 'crypto' is supported.

currencystring required

Currency code, in which the payout needs to be made.

addressstring required

Address to which funds will be withdrawn.

BVNK strictly enforces the EIP-55 checksum standard for mixed-case Ethereum addresses in Ethereum Virtual Machine (EVM) networks. If the casing doesn't exactly match the checksum, the address is considered invalid.

Make sure that the 0x prefix is lowercase and use one of the following formats:

  • All uppercase: 0xCCC2D224ADDEC8AA7A54BB22C7D4AC2D8ACA91BE

  • All lowercase: 0xccc2d224addec8aa7a54bb22c7d4ac2d8aca91be

tagstring

Tag of the payment destination. This field must not be empty when the paidCurrency currency value is XRP.

networkstring required

Network of the cryptocurrency. We recommend using the network parameter instead of protocol.

For the complete list of available networks, see Currencies.

protocolstring

Only used for multiple protocol currencies, like USDT. Will only generate address matching the protocol and no alternatives. Deprecated. Use network instead.

Example request

{
  "code": "crypto",
  "currency": "ETH",
  "address": "0xb794f5ea0ba39494ce839613fffba74279579268",
  "network": "ETHEREUM",
  "protocol": "ERC20"
}

Response

OK

Changes

No recorded changes to this operation across all 3 revisions of this API.