Loading...
You can integrate Card Blocking either through our Hosted Payment Page (HPP) or through direct API integration.
Card Blocking allows you choose which card types can be accepted for payment or stored for future-dated payments. You can set your block preferences at a payment-request or account level, stopping the transaction from being processed when triggered.
The following transaction types are supported:
The following card types can be blocked from processing an OTB and Authorization request:
Card blocking can be set up for specified accounts or within the payment request.
To set up Card Blocking for a specific account, please contact your account manager.
As you post the Payment Processing request (one of the supported requested types), a check of the card type is performed. Based on the returned card type, a card block will be applied if the card type matches an account or payment-request setting.
It’s important to note that your payment request overrides any account setting instructions. For example, if your payment request instructs to block Consumer Credit and your account setting is configured to block Consumer Credit AND Consumer Debit, only the Consumer Credit block rule will be applied. Use either account settings for configuring Card Blocking rules or at a payment-request level.
If the card type used is set to be blocked at an account or payment-request level, an error response code informing that the card type has triggered a block rule will be returned.
Card Blocking can be enabled at an account level or payment-request level. Here, we set it up at the payment-request level.
For syntax tables and security hash information, see the API Reference for Card Blocking.
<?xml version="1.0" encoding="UTF-8"?>
<request type="auth" timestamp="20180613141207">
<merchantid>MerchantId</merchantid>
<account>internet</account>
<channel>ECOM</channel>
<orderid>N6qsk4kYRZihmPrTXWYS6g</orderid>
<amount currency="EUR">1001</amount>
<card>
<number>4263970000005262</number>
<expdate>0425</expdate>
<chname>James Mason</chname>
<type>VISA</type>
<cvn>
<number>123</number>
<presind>1</presind>
</cvn>
</card>
<blockcard>
<commercialcredit>true</commercialcredit>
<commercialdebit>false</commercialdebit>
<consumercredit>false</consumercredit>
<consumerdebit>false</consumerdebit>
</blockcard>
<autosettle flag="1"/>
<sha1hash>87707637a34ba651b6185718c863abc64b673f20</sha1hash>
</request>Setting all card types to block is an invalid configuration and will result in the following error code:
<response timestamp="20220815171818">
<result>561</result>
<message>All card types are blocked, invalid request</message>
<orderid>N6qsk4kYRZihmPrTXWYS6g</orderid>
</response>Use our test cards to try different scenarios for your application to handle. See the Card Blocking section of our Test Cards article.
Explore more functionality to enrich your application.