Card Component

//Create a payment method object for cards.
let paymentMethod = paymentMethods.paymentMethod(ofType: cardComponentPaymentMethod.self)
//Create a configuration object for the cards Component.
var cardComponentConfiguration = cardComponent.Configuration()
//Set additional parameters on the configuration object.
cardComponentConfiguration.localizationParameters = //Optional custom localization parameters.

• splitCardFundingSources: Set to true.

curl https://checkout-test.adyen.com/v69/sessions \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
    "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
    "countryCode": "NL",
    "amount": {
        "currency": "EUR",
        "value": 4700
    },
    "splitCardFundingSources": true
}'

• splitCardFundingSources: Set to true.

curl https://checkout-test.adyen.com/v69/paymentMethods \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
    "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
    "countryCode": "NL",
    "amount": {
        "currency": "EUR",
        "value": 4700
    },
    "splitCardFundingSources": true
}'

{
    ...
    "paymentMethods": [
        {
            "brands": [
                "mc",
                "visa",
                "amex"
            ],
            ...
            "fundingSource": "credit",
            "name": "Credit Card",
            "type": "scheme"
        },
        {
            "brands": [
                "mc",
                 "visa",
                 "amex"
            ],
            "fundingSource": "debit",
            "name": "Debit Card",
            "type": "scheme"
        }
    ]
}

Creating a token

Making a payment with a token

Create a token

• storePaymentMethod: The data.storePaymentMethod from your client app.
• shopperReference: Your unique identifier for the shopper. If you don't want to show the switch for saving card details, set showsStorePaymentMethodField to false when adding the Card Component:

let configuration = CardComponent.Configuration(showsStorePaymentMethodField: false)
let component =  CardComponent(paymentMethod: paymentMethod,
                               apiContext: apiContext,
                               configuration: configuration)
component.delegate = self
self.cardComponent = component
present(component.viewController, animated: true)

Show a stored card in your payment form

1. Include in your /paymentMethods request:
   • shopperReference: The unique shopper identifier that you specified when creating the token.
   The /paymentMethods response includes a storedPaymentMethods array containing the stored payment methods for this shopper.
2. When you decode the paymentMethods response, find the StoredCardPaymentMethod object in the array named stored.
3. When adding the Card Component, specify:
   • paymentMethod: The StoredCardPaymentMethod object

   let component = CardComponent(paymentMethod: storedCardPaymentMethod,
                                apiContext: apiContext)
   component.delegate = self
   self.cardComponent = component
   present(component.viewController, animated: true)

Make a payment with a token

1. Pass the data.paymentMethod to your server.
2. From your server, make a /payments request, specifying:
   • paymentMethod: The data.paymentMethod from the didSubmit event from your client app.
   • shopperReference: The unique shopper identifier that you specified when creating the token.
   • shopperInteraction: ContAuth.
   • recurringProcessingModel: CardOnFile.
   Payment request with a token

   curl https://checkout-test.adyen.com/v68/payments \
   -H "X-API-key: [Your API Key here]" \
   -H "Content-Type: application/json" \
   -d '{
    "amount":{
      "value":2000,
      "currency":"USD"
    },
    "paymentMethod":{
      "type":"scheme",
      "storedPaymentMethodId":"8415718415172204",
      "encryptedSecurityCode":"adyenjs_0_1_18$MT6ppy0FAMVMLH..."
    },
    "reference":"YOUR_ORDER_NUMBER",
    "merchantAccount":"YOUR_MERCHANT_ACCOUNT",
    "returnUrl":"...",
    "shopperReference":"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
    "shopperInteraction":"ContAuth",
    "recurringProcessingModel":"CardOnFile"
   }'

   https://docs.adyen.com/pt/pt/payment-methods/cards/ios-component#payment-request-with-a-token

• resultCode: Use this to present the payment result to your shopper.

{
   "pspReference": "8815329842815468",
   "resultCode": "Authorised"
}

1. Create installment options

• monthValues: an array of unsigned integers for the number of installments offered. Must not be empty and must include integers greater than 1. For example, if you offer three, six, or nine installments, include [3, 6, 9].
• maxInstallmentMonth: an unsigned integer for the maximum number of installments offered. The result is the option from 2 to the number you specify. The integer must be greater than 1. For example, if you include 4, the shopper can choose 1, 2, 3, or 4 installments.

• includesRevolving: set to true to offer revolving installments. Default is false.

let installmentOptions = InstallmentOptions.init(monthValues: [3, 6, 9], includesRevolving: false)

let installmentOptions = InstallmentOptions.init(maxInstallmentMonth: 5, includesRevolving: true)

2. Create installment configuration

• Default options: apply to all card types. Create an installment configuration, providing the default options.

let installmentConfiguration = InstallmentConfiguration.init(defaultOptions: installmentOptions)
installmentOptions: installmentConfiguration

• Card-based options: offered based on card types. Create an installment configuration, providing the card-based options:

//Specify CardType. For example, for Visa, use [visa: installmentOptions].
let installmentConfiguration.init(cardBasedOptions: [CardType: installmentOptions])
installmentOptions: installmentConfiguration