Eligibility

Get supported currencies, countries, and states

The Eligibility API provides information on the currencies and regions supported by Blockchain.com Pay.

Get currencies

Returns an array of all currencies enabled on your account. Contact your account executive to customise your account settings.

GEThttps://api.blockchain.info/partner-gateway/partner-api/v1/currencies

Authorization

Response

Get the list of fiat and crypto currencies

Body

type*enum

Can be crypto or fiat

cryptofiat

name*string

Name of the currency

code*string

The alphabetical code used to identify the currency. The code is an abbreviated version of the currency name that is used to identify the currency. Sometimes referred to as the currency "ticker". Code is case sensitive.

precision*number

The number of decimal places supported by the currency. For example, Bitcoin has a precision of 8 decimal places, so the smallest possible unit of Bitcoin is 0.00000001 BTC. For USD, the precision is 2 decimal places, so the smallest possible unit of USD is 0.01 USD.

minBuyAmountstring

The minimum base currency amount a customer can use to buy crypto. For example, if minBuyAmount is 25 under USD fiat currency object, no orders for less than $25 can be placed. This field is only present for fiat currencies.

Example: 20

maxBuyAmountstring

The maximum base currency amount a customer can use to buy crypto. For example, for maxBuyAmount is 1200 under USD fiat currency object, no orders for more than $1200 can be placed. This field is only present for fiat currencies.

Example: 1200

networkstring

The network the currency is on. Can be BTC, ETH etc. Always null for fiat.

supportsDestinationTagboolean

Whether the currency supports destination tags / memo. This is true for example for XLM and XRP. Always null for fiat.

isSupportedInUSboolean

Whether purchases for this currency are supported in the US. Always null for fiat

allowedUSStatesarray of string

List of US states that are supported for this currency. US states are specified by the last 2 letter of their ISO 3166-2:US code. Always null for fiat

Request

const response = await fetch('https://api.blockchain.info/partner-gateway/partner-api/v1/currencies', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  [
    {
      "type": "FIAT",
      "name": "US Dollar",
      "code": "USD",
      "precision": 2,
      "minBuyAmount": 20,
      "maxBuyAmount": 1200
    },
    {
      "type": "CRYPTO",
      "name": "Bitcoin",
      "code": "BTC",
      "precision": 8,
      "network": "BTC",
      "supportsDestinationTag": false,
      "isSupportedInUS": true,
      "allowedUSStates": [
        "AL",
        "CT"
      ]
    }
  ]
]

Get countries and states

Returns an array of all countries and states supported by BcPay.

GEThttps://api.blockchain.info/partner-gateway/partner-api/v1/regions

Authorization

Query parameters

Response

Get eligible regions

Body

countries*array of Country (object)

usStates*array of UsState (object)

Request

const response = await fetch('https://api.blockchain.info/partner-gateway/partner-api/v1/regions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "countries": [
    [
      {
        "alpha2": "BE",
        "alpha3": "BEL",
        "isBuyAllowed": true,
        "name": "Belgium"
      },
      {
        "alpha2": "GB",
        "alpha3": "GBR",
        "isBuyAllowed": true,
        "name": "United Kingdom"
      },
      {
        "alpha2": "US",
        "alpha3": "USA",
        "isBuyAllowed": true,
        "name": "United States"
      }
    ]
  ],
  "usStates": [
    [
      {
        "alpha2": "CA",
        "isBuyAllowed": true,
        "name": "California"
      },
      {
        "alpha2": "FL",
        "isBuyAllowed": true,
        "name": "Florida"
      },
      {
        "alpha2": "WA",
        "isBuyAllowed": true,
        "name": "Washington"
      }
    ]
  ]
}

Get payment methods

Returns an array of all payment methods enabled on your account. Contact your account executive to customise your account settings.

GEThttps://api.blockchain.info/partner-gateway/partner-api/v1/payment-methods

Authorization

Response

Get eligible payment methods

Body

type*enum

Type of the payment method supported.

CARDAPPLE_PAYGOOGLE_PAY

supportedCurrencies*array of string

List of currencies supported for this payment method. Each Currency is specified by its alphabetical code. The code is an abbreviated version of the currency name, sometimes referred to as the currency "ticker". Code is case sensitive.

Request

const response = await fetch('https://api.blockchain.info/partner-gateway/partner-api/v1/payment-methods', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  [
    {
      "type": "CARD",
      "supportedCurrencies": [
        "USD",
        "GBP",
        "EUR"
      ]
    }
  ]
]

Last updated 5 months ago

[ [ { "type": "FIAT", "name": "US Dollar", "code": "USD", "precision": 2, "minBuyAmount": 20, "maxBuyAmount": 1200 }, { "type": "CRYPTO", "name": "Bitcoin", "code": "BTC", "precision": 8, "network": "BTC", "supportsDestinationTag": false, "isSupportedInUS": true, "allowedUSStates": [ "AL", "CT" ] } ] ]