Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Credit card installments

Learn how you can accept credit card payments in installments.

Installments in the UK

Installments are also available for some Mastercard holders in the United Kingdom. For more information, refer to Mastercard Installments UK.

Paying in installments is a popular form of credit card purchase in Brazil, Mexico, Turkey, and Japan.

When a shopper makes a purchase in installments, the cost is split into multiple smaller payments, each referred to as an installment. These are charged to the shopper's credit card every 30 days until their purchase has been paid in full. This is popular with shoppers as they receive goods or services immediately, but spread the cost of the purchase over multiple months.

Making an installment purchase is similar to making a regular credit card payment. The first installment is charged to the shopper's credit card immediately. All future installments will be charged automatically.

For cards that support 3D Secure, you can also accept installment payments with 3D Secure authentication.

Country Currency Payment type Refunds Partial refunds Separate captures Partial captures Chargebacks
Brazil BRL Credit card -white_check_mark- -white_check_mark- -white_check_mark- -white_check_mark- -white_check_mark-
Mexico MXN Credit card -white_check_mark- -white_check_mark- -white_check_mark- -white_check_mark- -white_check_mark-
Turkey TRY Credit card -white_check_mark- -white_check_mark- -x- -x- -white_check_mark-
Japan JPY Credit card -white_check_mark- -x- -x- -x- -white_check_mark-

Before you begin

Make sure that you have integrated one of our client-side solutions for collecting shopper's credit card details, or built your own payment form if you're collecting raw card data. For more information, refer to our Credit cards integration guide.

Make a payment

The number of installments you can offer to your shopper depends on their country:

Country Number of installments
Brazil Any
Mexico Either 3, 6, 9, 12, or 18 monthly installments.
Turkey Either 2, 3, 6, or 9 monthly installments.
Japan For regular installments, any number greater than 2 and less than 100.

Brazil, Mexico, and Turkey

To make an installment payment, additionally include in your /payments request:  

  • installments.value: The number of monthly installments.

In Brazil, you can charge the shopper interest for paying in installments. To do this, add the interest to the amount.value.

The following example shows how you would make a 120 Brazilian Real (BRL) purchase that will be paid in 6 installments of 20 BRL.

Make a payment with installments in BRL
curl https://checkout-test.adyen.com/v64/payments \
-H "X-API-key: [Your API Key here]" \
-H "Content-Type: application/json" \
-d '{
    "merchantAccount":"YOUR_MERCHANT_ACCOUNT",
    "reference":"installments test",
    "paymentMethod":{
      "type":"scheme",
      "encryptedCardNumber": "adyenjs_0_1_18$MT6ppy0FAMVMLH...",
      "encryptedExpiryMonth": "adyenjs_0_1_18$MT6ppy0FAMVMLH...",
      "encryptedExpiryYear": "adyenjs_0_1_18$MT6ppy0FAMVMLH...",
      "encryptedSecurityCode": "adyenjs_0_1_18$MT6ppy0FAMVMLH..."
    },
    "installments":{
      "value": 6
    },
    "amount":{
      "currency":"BRL",
      "value":120
    }
}'

If the payment is successful, the first installment is immediately charged to the shopper's credit card. You will receive a /payments response and an AUTHORISATION notification, same as regular credit card payments. All future installments will be charged automatically.

You will not receive notifications for subsequent installment payments. You can track whether an installment payment is successful with the Settlement details report. For more information, refer to Reconcile installment payments.

Japan

There are two types of installment plans in Japan:

  • Regular: You decide how many installments are offered at checkout for the shopper to choose. The number of installments must be greater than 2 and less than 100.
  • Revolving: A payment is split into an initial partial payment, and the remaining amount is split in installments. The cardholder must discuss the payment amounts with the card's issuer.

To make an installment payment, additionally include in your /payments request:  

  • installments.plan: The type of plan. Set this to either regular or revolving.
  • installments.value: The number of monthly installments.
    • regular: this must be set to greater than 2 and less than 100.
    • revolving: this must be set to 1.

The following example shows how you would make a 3000 Japanese Yen (JPY) purchase that will be paid in 10 installments of 300 JPY.

Make a payment with installments in JPY
curl https://checkout-test.adyen.com/v64/payments \
-H "X-API-key: [Your API Key here]" \
-H "Content-Type: application/json" \
-d '{
    "merchantAccount":"YOUR_MERCHANT_ACCOUNT",
    "reference":"installments test",
    "paymentMethod":{
      "type":"scheme",
      "encryptedCardNumber": "adyenjs_0_1_18$MT6ppy0FAMVMLH...",
      "encryptedExpiryMonth": "adyenjs_0_1_18$MT6ppy0FAMVMLH...",
      "encryptedExpiryYear": "adyenjs_0_1_18$MT6ppy0FAMVMLH...",
      "encryptedSecurityCode": "adyenjs_0_1_18$MT6ppy0FAMVMLH..."
    },
    "installments":{
      "value": 10,
      "plan":"regular"
    },
    "amount":{
      "currency":"JPY",
      "value": 3000
    }
}'

If the payment is successful, the first installment is immediately charged to the shopper's credit card. You will receive a /payments response and an AUTHORISATION notification, same as regular credit card payments. All future installments will be charged automatically.

You will not receive notifications for subsequent installment payments. You can track whether an installment payment is successful with the Settlement details report. For more information, refer to Reconcile installment payments.

Getting paid

How installment payments are processed, and when you receive the funds, depend on the shopper's country. For more information, refer to the country-specific information for Brazil, Mexico and Turkey, or Japan.

Brazil 

In Brazil, you receive funds for each installment as it is settled. There is a settlement delay of 30 days.

We also offer advancements if you need funds sooner. There is an additional fee for this service. Contact your Adyen Account Manager for details. 

For more information on how installments are settled and reconciled in Brazil, see Reconcile installment payments.

Mexico and Turkey

For installment purchases made in Mexico or Turkey, you will receive the funds in full when the first installment is settled.

You will be charged an additional fee by card schemes for installment purchases in Mexico and Turkey. Contact your Adyen Account Manager for details.

Japan

For installment purchases made in Japan, you will receive the funds in full when the first installment is settled.

Testing credit card installments

Before making installment payments with live credit cards, use our test card numbers to test your integration.

In Turkey, you can also test installment purchases using Izyico's test card numbers.

You can check the status of a test installment purchase in your Customer Area > Transactions > Payments.

See also