Complete an installment checkout flow
This how-to guide walks through the full installment path — seller setup, buyer card checkout with split payment, approved sale, and post-payment review. Read configure installments first for offer settings.
Installments apply to eligible card payments on supported one-time offers. They are not the same as subscription billing.
For card setup concepts, see PIX and card at checkout. For a standard card path without installments, see complete a card payment flow.
Part 1 — Seller setup (before the buyer pays)
- Confirm you are in the correct business workspace.
[Screenshot: App header — active business name and workspace switcher visible.]
- Open Products and select the product you are selling.
[Screenshot: Products list — target product row highlighted.]
- Open Pricing and select the plan and offer connected to your checkout.
[Screenshot: Pricing page — one-time plan and offer list for the selected product.]
- Open the offer and enable installments with the correct number of splits.
[Screenshot: Offer installment settings — installments enabled with count and total price visible.]
- Confirm card is enabled as a payment method on the offer.
[Screenshot: Offer payment methods — card enabled; PIX optional if also offered.]
- Open Checkout and select the checkout link buyers will use.
[Screenshot: Checkout links list — target link with product, offer, and copy button.]
- Open the checkout builder and confirm installment terms are readable near the payment action.
[Screenshot: Checkout preview — total price and installment count visible above pay button.]
- Confirm the checkout page is published.
[Screenshot: Checkout builder — Published status badge visible.]
- Copy the checkout link for your test.
[Screenshot: Checkout link copy action — URL copied to clipboard.]
Part 2 — Buyer checkout (installment card payment)
- Open the checkout link in a browser (test on mobile — installment copy must stay readable).
[Screenshot: Live checkout page — offer summary and card payment section visible.]
- Enter buyer details if the checkout requests email, name, or document.
[Screenshot: Checkout buyer fields — email and required fields filled in.]
- Select Credit card as the payment method.
[Screenshot: Payment method selector — card selected for installment-eligible offer.]
- Review the installment options shown (for example 3x, 6x, or 12x).
[Screenshot: Installment selector — multiple split options with per-installment amount visible.]
- Select the installment option the buyer wants.
[Screenshot: Installment option selected — total and per-charge amount highlighted.]
- Enter card number, expiry, CVV, and cardholder name.
[Screenshot: Card payment form — all card fields filled in.]
- Submit payment and wait for the checkout response.
[Screenshot: Checkout processing state — installment card payment submitting.]
- Confirm the checkout shows success for an approved payment or a clear declined message.
[Screenshot: Checkout success page — installment purchase approved and thank-you visible.]
Part 3 — Seller review (after the buyer pays)
- Open Sales in the seller app.
[Screenshot: Sales list — filters and date range visible.]
- Search by the buyer email used in the test.
[Screenshot: Sales search — buyer email entered and matching installment sale row visible.]
- Open the sale and confirm status is Approved.
[Screenshot: Sale detail — Approved status, card payment method, and installment indicator visible.]
- Confirm delivery was granted only after approval.
[Screenshot: Buyer access confirmation — delivery granted for approved installment sale.]
- Brief support on how to explain installment charges if buyers ask about multiple card entries.
[Screenshot: Internal support note — installment explanation for agents.]
Installment status cheat sheet
| What you see | What it means | What to do |
|---|---|---|
| Installment options missing at checkout | Offer or card flow does not support installments | Recheck installment settings and payment methods |
| Declined at checkout | Card issuer rejected the attempt | Buyer retries or uses another method; see card declines |
| Approved | First installment charge confirmed | Grant delivery; explain future charges if buyers ask |
| Buyer disputes total vs per-charge amount | Checkout copy was unclear | Fix checkout copy; review refunds policy |
Common mistakes
- Enabling installments without testing buyer-facing totals on mobile.
- Confusing installments with subscription renewals.
- Granting delivery before the sale shows Approved in Sales.
- Promising one total price on the sales page but showing different installment math on checkout.