Installments with interest (MCI)
Configure an MCI campaign, display the returned financed amounts, and send the selected term in Purchase V2.
MCI lets a customer divide a purchase into installments while the applicable financing increases the amount the customer pays. The campaign and eligible provider determine the rate and amounts; the installment response is the authoritative offer shown at checkout.
MCI campaign model#
Configure an MCI campaign under Admin → Installments configuration.
| Configuration | Purpose |
|---|---|
| Campaign type | Select MCI. |
| Currency and validity | Limit the campaign to its currency and optional active dates. |
| Payment providers | Choose compatible connections that can process the financed terms. |
| Installment terms | Add the supported numbers of payments. |
| Card brands | Enable the brands to which each term applies. |
| Minimum and maximum amount | Define the eligible per-installment amount range for each brand and term. |
| Interest rate | Define the rate used by the configured MCI calculation for that rule. |
DEUNA resolves the campaign together with the order's merchant and store, amount, currency, detected card brand, eligible processors, and routing constraints. Provider-supplied plans can also constrain the final set when that capability is enabled for the connection.
Present the financed amount#
Do not calculate or overwrite MCI values in the checkout. Render the values returned by List installment options, including the customer-facing label, per-installment amount, rate, and financed total.
{
"installments": [
{
"installments": 6,
"installments_amount": 19000,
"display_installments_amount": "MXN 190.00",
"installment_rate": 2.25,
"display_installment_label": "6 payments of MXN 190.00 with interest",
"plan_option_id": "838cb602-c890-4be2-b7f0-9cd8c18a784b",
"installment_total_amount": 114000,
"display_installment_total_amount": "MXN 1,140.00"
}
]
}In this example, the base purchase and the financed total are different. The shopper must be able to review the returned financed terms before confirming payment.
Send the customer's selection#
Copy both values from the selected response item:
{
"payment_source": {
"method_type": "credit_card",
"card_info": {
"card_id": "CARD_ID",
"installments": 6,
"installment": {
"plan_option_id": "838cb602-c890-4be2-b7f0-9cd8c18a784b"
}
}
}
}installmentstells Payments how many installments the customer selected.installment.plan_option_ididentifies the exact resolved option, including its MCI amounts and eligible processors.
Do not send the rate, financed total, or formula as a substitute for the option ID. DEUNA retrieves the selected plan from that ID and applies its resolved values during payment processing.
Test MCI#
- Use an active MCI campaign, supported provider connection, and approved sandbox card.
- Keep the order currency and card brand within the campaign rule, and use an order amount whose calculated installment is inside the configured range.
- Confirm that the response shows the expected rate, per-installment amount, and financed total.
- Confirm that the checkout discloses the financed total before the customer pays.
- Purchase with the returned count and option ID and verify the resulting payment values.
If the response is empty, the transaction does not currently match an eligible installment option. Check the campaign status and validity, store, currency, card brand, per-installment amount range, provider, and routing configuration.
For VTEX-specific sources and commercial conditions, continue with VTEX installments. For the shared retrieval and payment flow, return to Installments.