Overview
With Web SDK, you can specify cards you do not accept (card blocking). With Simply Connect, you can specify cards you do not accept or cards that you accept (card whitelisting). This topic describes how to specify cards you do not accept or cards that you accept.
Card Attributes
Whether you are specifying cards you do not accept or cards that you accept, use one or more arrays of possible values for the following card attributes:
brand
– Possible values: visa, mastercard, amex, diners, discover, jcb, dankort, unionpay.cardProduct
– Possible values: debit, credit.cardType
– Possible values: consumer, corporate.country
– Possible values: Any ISO 3166-1 two-letter country code.
Syntax
The syntax for specifying cards is:
blockCards
or cardWhiteList
: [[[ "value1"
][, "value2"
][, "value3"
][, "value4"
]], [array2], [arrayN]]
The intersections of each array of card attribute values determine which cards you do not accept or which cards you accept; that is, cards that meet all specified attributes in an array, using AND logic.
For example, to specify that you do not accept corporate Visa credit cards and prepaid British American Express cards:
blockCards
: [[“visa”,”credit”,”corporate”],[“amex”,”GB”,”prepaid”]]
Support
When you initialize Nuvei Web SDK using SafeCharge()
, you can include blockCards
.
With Simply Connect, you can include cardWhiteList
or blockCards
in a checkout()
or withdrawal()
request. Do not include both cardWhiteList
and blockCards
.
Additional Resources
For more information and examples:
- For Web SDK, see Web SDK Advanced Features Blocking Cards.
- For Simply Connect
checkout()
requests, see Simply Connect Payment Customization Blocking and Whitelisting Cards. - For Simply Connect
withdrawal()
requests, see thewithdrawal()
input parameters tables.