On This Page
Dual-Branded Cards
Unified Checkout
accepts dual-branded cards. To use this feature, you must
include the card networks that have overlapping BIN ranges in the capture context
request. For
example:"allowedCardNetworks": ["VISA", "MASTERCARD", "AMEX", "CARTESBANCAIRES"]
When a card number within an overlapping BIN range is entered, the network that is listed
first in the value array for the
allowedCardNetworks
field is used.
Based on the previous example, if the card number 403550XXXXXXXXXX is entered, the
payment network for payment processing is Visa. During the transaction, the card type is populated with the first network in the list,
and the
detectedCardTypes
field returned in the transient token includes all of
the detected card types in the transient token.The
detectedCardTypes
field is returned in the transient token
response only when more than one card type is detected.If you include Cartes Bancaires as a supported dual-branded card type,
Unified Checkout
displays a radio button with Visa and Mastercard options at
checkout. This enables the customer to select which payment scheme they want to use to
process the payment. The radio button defaults to the card type that you specify in the
capture context request, but the payment is processed using the option selected by the
customer during checkout.Domestic Scheme Rules
For markets where domestic routing, network preference, or co-badging regulations
apply, you are responsible for ensuring that domestic payment schemes are
prioritized appropriately within the
allowedCardNetworks
configuration.In these scenarios, domestic schemes must be listed ahead of international networks
such as Visa or Mastercard where required by local regulations or scheme rules.
If network preference varies by transaction, the order of networks should be
dynamically configured when you create the capture context request using the
Sessions API.
You are responsible for reviewing and complying with all applicable local regulatory,
scheme, and acquirer requirements relating to domestic routing and network
selection.