onCardTypeChange Callback
The onCardTypeChange( ) method invokes the callback function when the card type is first detected or changed.
Usage Copied to clipboard
PaymentSession.onCardTypeChange(function(selector, result), [scope]);
Example Copied to clipboard
PaymentSession.onCardTypeChange(function(selector, result) {
//handle change event
if (result.status === 'SUPPORTED') {
// use card details like brand, fundingMethod, issuer and scheme
console.log(result.brand);
console.log(result.fundingMethod);
console.log(result.issuer);
console.log(result.scheme);
console.log(result.order.amount);
console.log(result.order.netAmount);
console.log(result.order.merchantCharge.type);
console.log(result.order.merchantCharge.amount);
console.log(result.capabilities);
console.log(result.interactionConstraints);
console.log(result.paymentPlans);
console.log(result.localBrand);
console.log(result.currencyConversion.offerText);
console.log(result.currencyConversion.payerAmount);
console.log(result.currencyConversion.payerCurrency);
console.log(result.currencyConversion.requestId);
} else if (result.status === 'INSUFFICIENT_LENGTH') {
// selector for invalid field is provided
console.log('Minimum of 10 digits required to determine card type.');
} else if (result.status === 'NOT_SUPPORTED') {
console.log('The card type you entered is not supported.');
}
});
Arguments Copied to clipboard
The callback function invoked with selector and the result when an event is triggered.
Identifier of the HTML element which is card-number.
Result object which sent as an argument to the function.
The brand name used to describe the card that is recognized and accepted globally.
The method used by the payer to provide the funds for the payment.
The issuer of the card, if known.
The organization that owns a card brand and defines operating regulations for its use.
The total amount for the order.
The amount payable for the order before surcharging is applied.
Information about additional fees that you are charging the payer for processing the payment for this order, for example, a surcharge, convenience or service fee.
The type of the additional fee that you are charging the payer.
Value must be a member of the following list. The values are case-sensitive.
CONVENIENCE_FEEA fee that covers the cost of accepting a payment using a
non-standard payment channel for your business, for example, a payment made over the
phone rather than using your website.
SERVICE_FEEA type of convenience fee with specific rules and restricted to
education and government merchants with specific merchant category codes (MCC).
SURCHARGEA fee that covers your cost of accepting a payment method.
The amount of the additional fee that you are charging the payer.
Value must be a member of the following list. The values are case-sensitive.
ADDRESS_VERIFICATIONIndicates if you are allowed to use the Address Verification
Service (AVS) to verify address details supplied by the cardholder.
CARD_SECURITY_CODEIndicates if you are allowed to use the Card Security Check to
verify the Card Security Code (CSC) supplied by the cardholder.
NO_CARD_SECURITY_CODE_PRINTED_ON_CARDIndicates if you are allowed to accept
payments from credit cards without a Card Security Code (CSC) printed on the card.
Indicates if the cardholder is required to provide additional information when using a card to pay for the order.
Value must be one or more comma separated members of the following list. The values are case-sensitive.
CREDIT_DEBIT_SELECTIONIndicates if the cardholder must be forced to select between
using a credit card or a debit card, before entering their card details.
CARD_TYPE_SELECTIONIndicates if the cardholder must be forced to select the card
type.This is required when the card is identified as a co-branded card and regulation stipulates
that the payer must select the card type.The card type selected by the payer must subsequently
be provided in field sourceOfFunds.provided.card.cardType on financial transaction requests.
CARD_SECURITY_CODE_ENTRYIndicates if the cardholder must be forced to enter the
Card Security Code (CSC) when using a credit card to pay for the order.
Information on valid payment plans for this order based on the values supplied in the request parameters.
The brand name used to describe a card that is recognized and accepted within its country/region of origin.
This is a piece of HTML markup that can be included as part of your website to offer the payer the currency conversion quote.
The total amount of the transaction in the payer's currency.
The currency of the DCC rate quote provided by your DCC Service Provider.
The unique identifier for your DCC quote request as returned in the PAYMENT_OPTIONS_INQUIRY response.
The optional named instance of a card payment data set within a session. See Multiple Hosted Sessions for more information.
Return Value Copied to clipboard
None