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:

Blacklist level Scope Checked when…
Global System-wide block Always
Merchant Specific to your merchant account Always
Terminal Specific to a terminal token terminal_token is provided

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