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.

Create A Direct Flow Credit Card Payment With Installments

You need to use the installment 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.

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": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "amount": 300000,
    "currency": "UYU",
    "country": "UY",
    "paymentMethod": "CARD",
    ...  # other basic request fields
    "paymentProposalInfo": {
        "proposalId": "beb199db-fb9c-481b-a951-73b905d5ce43"
    },
    "installments": 3,
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "referenceId": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "paymentMethod": "CARD",
    "amount": 300000,
    "currency": "UYU",
    "finalAmount": 306000,
    "finalCurrency": "UYU",
    "country": "UY",
    ...  # other basic response fields
    "amountDetails": {
        "installmentAmountDetails": {
             "installmentAmount": 102000,
            "installments": 3,
            "totalAmount": 306000
        }
    },
    ...  # 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 for Direct flow.

Response Body Parameters

Parameter Type Description
amountDetails JSON The payment installments amount details.

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.

Object Parameters

paymentProposalInfo
Parameter Required Type Description
proposalId String The installment proposal ID. Required for Direct flow.
paymentIntentInfo JSON The payment Intent info. Required for Redirect flow.
paymentIntentInfo
Parameter Required Type Description
installmentPlanId String The installment plan ID.
amountDetails
Parameter Type Description
installmentAmountDetails JSON The installment amount details.
installmentAmountDetails
Parameter Type Description
installmentAmount Long Installment amount.
installments Integer Number of installments.
totalAmount Long Installments total amount.
Back to top