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

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

Our Android Drop-in<\/a> renders the available cards in your payment form, and securely collects sensitive card information, so it doesn't touch your server.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have built an Advanced flow Android Drop-in integration<\/a>. <\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\nBefore you begin, add the cards that you want to accept in your Customer Area<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Show the available cards in your payment form<\/h2>\n
\n

For information about the supported locations and currencies for each card, refer to Payment methods<\/a>.<\/p><\/div><\/div>\n\n

To show cards in your payment form, specify in your \/paymentMethods<\/a> request a combination of countryCode<\/a> and amount.currency<\/a>. Drop-in uses this information to show the available payment methods to your shopper.<\/p>\n

Optional configuration<\/h3>\n

When creating an instance of Drop-in<\/a>, you can optionally include a \n CardConfiguration<\/code>\n<\/a> object to add configuration parameters for cards in your payment form.<\/p>\n

The following example shows how to configure Drop-in to make the cardholder name required:<\/p>\n

\/\/ Optional. Add this if you need any custom configuration for the component.\nval cardConfiguration = CardConfiguration.Builder(context, \"YOUR_CLIENT_KEY\")\n    \/\/ Makes the cardholder name required\n    .setHolderNameRequired(true)\n    \/\/ When you are ready to accept live payments, change the value to one of our live environments.\n    .setEnvironment(Environment.TEST)\n    .build()\n\nval dropInConfiguration = DropInConfiguration.Builder(context, YourDropInService::class.java, \"YOUR_CLIENT_KEY\")\n     \/\/ When you are ready to accept live payments, change the value to one of our live environments.\n     .setEnvironment(Environment.TEST)\n     .addCardConfiguration(cardConfiguration)\n     .build()<\/code><\/pre>\n
Address fields configuration<\/h4>\n
Configure the postal code field in AddressConfiguration.PostalCode<\/code>.<\/p>\n
Include the following parameter:<\/p>\n\n\n\n\n\n
Parameter<\/th>\nDescription<\/th>\nDefault value<\/th>\n<\/tr>\n<\/thead>\n
addressFieldPolicy<\/code><\/td>\nSet if shoppers are required to fill in the fields. 
 Possible values: 
 - Required<\/strong> 
 - Optional<\/strong> 
 - OptionalForCardTypes<\/strong>: include the brand<\/code> parameter, which is a list of values of type String<\/code> to specify which brands input is optional for.<\/td>\n		Required<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n    <\/code-sample>\n<\/div>\n
Make a payment<\/h2>\n
When the shopper proceeds to pay, Drop-in returns the paymentComponentData.paymentMethod<\/code>.<\/p>\n
    \n
  1. Pass the paymentComponentData<\/code> to your server.<\/li>\n
  2. From your server, make a  \/payments<\/a> request, specifying:\n