Check card status via Blacklist API

Use the Blacklist API to check whether a credit card is blacklisted in the gateway system. This is useful for fraud prevention and transaction filtering.

What is the Blacklist API?

The Blacklist API allows merchants to verify if a specific card number (PAN) is on any of the following blacklist levels:

• Global blacklist: A system-wide block
• Merchant-level blacklist: Specific to the merchant
• Terminal-level blacklist: Specific to the terminal token

If the terminal_token is not provided, only the merchant-level and global blacklists are checked.

If the terminal_token is provided, all three levels (terminal, merchant, and global) are checked.

Request parameters

Parameter	Required	Format	Description
card_number	Yes	int(13..16)	Credit card number to be checked
terminal_token	No	string(40)	Token identifying a terminal; enables terminal-level blacklist checks

Request example

<blacklist_request>
  <card_number>4200000000000000</card_number>
  <terminal_token>abd30ed00f88f838c5d233cbb62b6da0b69267b4</terminal_token>
</blacklist_request>

Response example

<blacklist_response>
  <blacklisted>true</blacklisted>
</blacklist_response>

Response parameters

Parameter	Type	Description
blacklisted	boolean	Whether the card is blacklisted (`true` or `false`)

Error response example

<blacklist_response>
  <code>350</code>
  <message>Invalid XML: No close tag for /blacklist_request</message>
</blacklist_response>

Error response parameters

Parameter	Type	Description
code	integer	API error code
message	string	Details about the error