Credit Cards API

Credit cards API

Get card scheme

The first six digits of a card number are the Bank Issuer Number (BIN). The BIN indicates which bank issued the credit card. This is sometimes known as an Issuer identification number (IIN). Use this resource to return the card scheme from the BIN.

This resource is useful in combination with listing accepted cards and listing card surcharges in the Businesses API.

Request

GET /credit-cards/card-schemes/{cardBIN}

Use your Publishable API key to access this resource.

Path parameters

Parameter Name Format Description
cardBIN string The first six digits of a card number.

Request body

None.

Response

If successful, this method returns the following in the response body.

Field Format Description
links Array of Links Links to related documents and resources.
cardScheme string The card scheme code. One of VISA, MASTERCARD, AMEX, DINERS, JCB, or UNIONPAY.

For example:

{
  "links": [],
  "cardScheme": "VISA"
}

HTTP status codes

See HTTP Status Codes for more.

Status Code Description More information
200 OK The request has succeeded.
404 NOT FOUND The cardBIN path parameter did not match any known BIN.
422 UNPROCESSABLE ENTITY The cardBIN path parameter was an invalid number, less-than or greater-than 6 digits, or not a valid card BIN. View more