Card BIN API

Cashfree provides a card bin API for seamless merchants to know the card type. This API requires special access from Cashfree, you can reach out to [email protected] for access this to API.

This API offers two different responses, depending on your access level. While the simple response is free for all users, we charge a setup fees (and annual recurring charges) for the detailed response. You can view the two responses below.

🚧

Card bin accuracy

We strive to keep our bin database updated with scheme changes. However, there might be scenarios where specific bin updates might not be applied to our system. This can happen because of different reasons. If you are using this API for critical applications like applying merchant discount rate, it is better that you get these details from the card schemes or authorised resellers.

curl --request POST \          
--url https://api.cashfree.com/api/v1/vault/cards/cardbin \
--header 'content-type: application/x-www-form-urlencoded' \
--data appId={appId} \
--data secretKey={secretKey} \
--data cardBin=529252

{
	"status": "OK",
	"cards": {
		"scheme": "mastercard",
		"bank": "CITI Bank",
		"countryCode": "IN"
	}
}

{
	"status": "OK",
	"cards": {
		"scheme": "mastercard",
		"type": "debit",
		"bank": "CITI Bank",
		"countryCode": "IN",
		"subType": "R"
	}
}