Card info request

The card info request lets you receive information on the credit card product from the system’s database. The request requires authorization by the shop’s secret_key and the request body must contain the card’s BIN or PAN.

Card info request

POST https://{api-url}/credit-cards/bins/info

Request

Authorization

The request requires Basic authorization type with the shop’s id and secret_key.

Header parameters

Parameter	Required	Type	Description
`Content-Type`	mandatory	`string (20)`	`application/json`

Body parameters

Parameter	Required	Type	Description
`number`	mandatory	`string (6–19)`	the card’s BIN (the first 6–12 digits of the credit card number) or the card’s PAN (Personal Account Number, up to 19 digits).

Example of the request

{
  "number": "420000"
}

Response

Response parameters

Parameter	Type	Description
`response`	`object`
`code`	`string`	Transaction processing code.
`message`	`string`	A processing result message.
`friendly_message`	`string`	`code` description for the customer.
`data`	`array`	Data array with the information on the card products found for the specified BIN/PAN.

The parameters of objects in the data[]

If no cards were found by the specified BIN/PAN, an empty array will be returned.

Parameter	Type	Description
`id`	`integer`	Unique identifier of the database entry on the card product.
`issuer_name`	`string`	Card issuer name.
`issuer_country`	`string` `(2)`	The country of the card issuer.
`brand`	`string`	Card brand name. For example, `visa`, `mastercard`.
`sub_brand`	`string`	A subbrand name.
`currency`	`string`	The currency of the card. The parameter is returned only for the cards of the selected banks.
`product`	`object`	The object with the card product parameters.

product{} parameters

Parameter	Type	Description
`code`	`string`	The product code for the card.
`name`	`string`	Card product name, used for loyalty programs, for example, `Gold MasterCard`.
`category`	`string`	Card product category: debit or credit.

Example of the response

{
    "response": {
        "code": "S.0000",
        "message": "The request was successful.",
        "friendly_message": "The request was successful.",
        "data": [
            {
                "id": 796,
                "issuer_name": "VISA Demo Bank",
                "issuer_country": "US",
                "product": {
                    "code": "F",
                    "name": "Visa Classic"
                }
            }
        ]
    }
}