Consulta BIN

Query the BIN (first six to nine digits of the card) and return card information.

EnvironmentMethodEndpoint
Sandboxhttps://apiquerysandbox.cieloecommerce.cielo.com.br/1/cardBin/{BIN}
Productionhttps://apiquery.cieloecommerce.cielo.com.br/1/cardBin/{BIN}

ℹ️

Important

  • To enable Consulta BIN, contact Cielo support team;
  • Some BINs or card brands may not return card information.
⚠️

Warning

  • To use Consulta BIN in sandbox, check the simulation scenarios in Consulta BIN sandbox
  • On sandbox environment, the returned data is simulated, so they are not valid BIN results. Only fields and format must be considered. For real identification of the BIN, you must use production environment.
Path Params
int32
required

It’s the first six or nine digits of the card.

Headers
string
required

Merchant identifier in API E-commerce Cielo. Size: 6. This documentation provides a default MerchantId to allow testing in the sandbox, but you can also provide the enabled MerchantId during the deployment process.

string
required

Public Key for Double Authentication in API E-commerce Cielo. Size: 40. This documentation provides a default MerchantKey to allow testing in the sandbox, but you can also provide the enabled MerchantKey during the deployment process.

string

Request identifier, used when the merchant uses different servers for each GET/POST/PUT. Size: 36.

Responses

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