Mastercard Installments UK

Mastercard provides the option of issuer-financed installments to their customers in the United Kingdom. Adyen forwards the installment options from the issuer to the customer.
If the customer has enabled installment payments on their account, they can review installment options, and make a selection. 

Authorisation Response

Installment options are returned to the customer in the authorisation response in additionalData:

  "additionalData": {
    "receiptFreeText":"Message to the merchant to be displayed on Terminal/shopper",
    "installmentPaymentData.installmentType":"IssuerFinanced",
    "installmentPaymentData.paymentOptions":"PayInInstallmentsOnly",
    "installmentPaymentData.option_1.numberOfInstallments":"0",
    "installmentPaymentData.option_1.interestRate":"11.0",
    "installmentPaymentData.option_1.installmentFee":"200",
    "installmentPaymentData.option_1.annualPercentageRate":"0.2",
    "installmentPaymentData.option_1.firstInstallmentAmount":"1800",
    "installmentPaymentData.option_1.subsequentInstallmentAmount":"0",
    "installmentPaymentData.option_1.minimumNumberOfInstallments":"12",
    "installmentPaymentData.option_1.maximumNumberOfInstallments":"24",
    "installmentPaymentData.option_1.totalAmountDue":"21800"
  }
<additionalData xmlns="http://acm.services.adyen.com">
          <entry>
            <key xsi:type="xsd:string">receiptFreeText</key>
            <value xsi:type="xsd:string">Message to the merchant</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.installmentType</key>
            <value xsi:type="xsd:string">IssuerFinanced</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.paymentOptions</key>
            <value xsi:type="xsd:string">PayInInstallmentsOnly</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.numberOfInstallments</key>
            <value xsi:type="xsd:string">0</value>
          </entry>    
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.interestRate</key>
            <value xsi:type="xsd:string">11.0</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.installmentFee</key>
            <value xsi:type="xsd:string">200</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.annualPercentageRate</key>
            <value xsi:type="xsd:string">0.2</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.firstInstallmentAmount</key>
            <value xsi:type="xsd:string">1800</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.subsequentInstallmentAmount</key>
            <value xsi:type="xsd:string">0</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.minimumNumberOfInstallments</key>
            <value xsi:type="xsd:string">12</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.maximumNumberOfInstallments</key>
            <value xsi:type="xsd:string">24</value>
          </entry>
          <entry>
            <key xsi:type="xsd:string">installmentPaymentData.option_1.totalAmountDue</key>
            <value xsi:type="xsd:string">21800</value>
          </entry>
</additionalData>

Options could be incremented based on the number of installment options supplied by the Issuer, such as: option_1, option_2, option_3.

For a list of AdditionalData fields passed in the response, see PaymentResult.AdditionalData.

Capture request

The selected installment option is returned to the issuer in the capture request:

  "additionalData": {
    "installmentPaymentData.selectedInstallmentOption":"1"
  }
<additionalData>
            <entry>
            <key xsi:type="xsd:string">installmentPaymentData.selectedInstallmentOption</key>
            <value xsi:type="xsd:string">1</value>
          </entry>
</additionalData>
For a list of AdditionalData fields passed in the capture request. For more information on these fields, see ModificationRequest.additionalData.