{"title":"Cards Drop-in integration","category":"default","creationDate":1776961628,"content":"

This page explains how to add cards to your existing Drop-in integration.<\/p>\n

Requirements<\/h2>\n

Select the server-side flow<\/a> that your integration uses:<\/p>\n\n

\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

API reference<\/h2>\n\n
\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

Drop-in configuration<\/h2>\n\n
\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

Optional configuration<\/h3>\n

You can include the following parameters in the configuration object:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
holderNameRequired<\/code><\/td>\nSet to true<\/strong> to require the cardholder name.<\/td>\n<\/tr>\n
addressMode<\/code><\/td>\nSpecify which address fields are required. Possible values:
-full<\/strong>: require the full address.
-postalCode<\/strong>: require the postal code.
-none<\/strong>: address not required.<\/td>\n<\/tr>\n
showCvc<\/code><\/td>\nSet to true<\/strong> to show the security code (CVC\/CVV\/CID) in the payment form.<\/td>\n<\/tr>\n
supportedCardTypes<\/code><\/td>\nA list of supported card types<\/a> that you recognize.<\/td>\n<\/tr>\n
socialSecurityNumberFieldVisibility<\/code><\/td>\nSpecify if the social security number field shows. Possible values
-show<\/strong>: show the field.
-hide<\/strong>: do not show the field.<\/td>\n<\/tr>\n
showStorePaymentMethodField<\/code><\/td>\nSet to true<\/strong> to show the option to store card details for recurring payments.<\/td>\n<\/tr>\n
showCvcForStoredCard<\/code><\/td>\nSet to true<\/strong> to show the security code (CVC\/CVV\/CID) of stored cards.<\/td>\n<\/tr>\n
kcpFieldVisibility<\/code><\/td>\nFor Korean cards, sets if the security field shows in the payment form. Possible values:
-show<\/strong>: show the field.
-hide<\/strong>: do not show the field.<\/td>\n<\/tr>\n
onBinLookup<\/code><\/td>\nCalled when the shopper enters the card number. Requires a minimum of 11 digits of the card number to be entered. Returns the following
  • brand<\/code>: The brands on the card.<\/li><\/ul><\/td>\n<\/tr>\n
onBinValue<\/code><\/td>\nCalled when the shopper enters the card number. Returns the following