Skip to content

Installments

Making a credit card installment purchase is similar to making a regular card payment. End users can choose to pay the total transaction amount in periodically scheduled separated payments. The first installment is charged to the shopper's credit card immediately, and the following installments are charged automatically.

To create a payment with installments, first you need to contact Liquido to create an Installments Plan and you’ll get a Plan ID offline. Then you need to use this plan ID to Create an Installments Proposal to get a proposal ID. Keep in mind that when you need to include other proposals together with Installments proposal, you’ll need to Create A Proposal with Multiple Intentions. With a Proposal ID(proposalId) and the number of installments(installments), you can go ahead to create a credit card installment payment.

Create A Credit Card Payment With Installments

To create a payment with installments, first you need to contact us to create an Installments Plan, and then you need to create an Installments Proposal, to get the installments details and create a payment with installments.

With the Installment Proposal ID(proposalId) and the number of installments(installments), you can go ahead and create a payment with installments.

Important Note: Regardless of the number of installments, most credit card services in Mexico require the single installment amount to be over 100 MXN.

HTTP Request

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Request Body
{
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "amount": 100000,
    "currency": "USD",
    "country": "MX",
    "paymentMethod": "CREDIT_CARD",
    ...  # other basic request fields
    "paymentProposalInfo": {
        "proposalId": "beb199db-fb9c-481b-a951-73b905d5ce43"
    },
    "installments": 12,
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "referenceId": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "paymentMethod": "CREDIT_CARD",
    "amount": 100000,
    "currency": "USD",
    "finalAmount": 551093,
    "finalCurrency": "MXN",
    "country": "MX",
    ...  # other basic response fields
    "amountDetails": {
        "fxAmountDetails": {
            "fxRate": {
                "modifierType": "RATE",
                "base": "USD",
                "target": "MXN",
                "timestamp": 1664443743,
                "exchangeRate": 17.4835098
            },
            "baseAmount": 100000,
            "targetAmount": 548351
        },
        "installmentAmountDetails": {
            "installmentAmount": 45924,
            "installments": 12,
            "totalAmount": 551093
        }
    },
    ...  # other basic response fields
}

HTTP Headers Details

Key Value
Authorization "bearer" + " " + {{access_token}}
x-api-key {{api_key}}

Request Body Parameters

Parameter Required Type Description
paymentProposalInfo JSON The payment installment proposal info. Required if create a payment with installments.
installments Integer Number of installments. Required if create a payment with installments.

Response Body Parameters

Parameter Type Description
amountDetails JSON The payment installments amount details.

Object Parameters

paymentProposalInfo
Parameter Required Type Description
proposalId String The installment proposal ID. Required if create a payment with installments.
amountDetails
Parameter Type Description
taxAmountDetails JSON The tax amount details.
fxAmountDetails JSON The fx amount details.
installmentAmountDetails JSON The installment amount details.
taxAmountDetails
Parameter Type Description
taxRate JSON The tax rate details.
amount Long The tax amount.
fxAmountDetails
Parameter Type Description
fxRate JSON The foreign exchange rate details.
baseAmount Long The amount of base currency.
targetAmount Long The amount of target currency.
installmentAmountDetails
Parameter Type Description
installmentAmount Long Installment amount.
installments Integer Number of installments.
totalAmount Long Installments total amount.
taxRate
Parameter Type Description
rate Positive Float Tax rate.
type String Tax type.
fxRate
Parameter Type Description
base String Base currency, e.g. USD
target String Target currency, e.g. MXN
timestamp Long The timestamp when exchanging currency.
exchangeRate Positive Float The exchange rate.
Back to top