All articles
ProductJul 25, 2026 · 7 min

Partial Returns and Split Payments: A Routing Guide

DA
Defne Aksoy
Solutions Engineer

Processing a return for a single item bought with a single credit card is a solved problem. The complexity explodes when a shopper buys three items using a combination of a digital gift card, a promotional discount code, and a Buy Now, Pay Later (BNPL) service, and then decides to return only one of those items. Which payment method receives the refund? How is the discount prorated? Who eats the transaction fees?

When operations teams lack a systemic approach to split payments, partial returns become an accounting nightmare. Support agents are forced into manual calculations, leading to over-refunds, broken ledgers, and infuriated shoppers who receive cash back on a non-refundable gift card rather than their primary bank account. This guide breaks down the architectural logic of mixed-tender refunds and how to automate the refund waterfall.

The accounting nightmare of mixed-tender

Consider a €150 order containing two €75 items. The shopper pays with a €50 store credit gift card and puts the remaining €100 on their Visa. They return one €75 item. If your system arbitrarily refunds €75 to the Visa, you have effectively allowed the shopper to cash out €25 of non-refundable store credit. You have leaked cash flow.

According to checkout UX research by Baymard Institute, shoppers expect refunds to be routed logically, typically preferring cash back to their primary card before having store credit restored. However, the merchant's financial imperative is the exact opposite. You want to retain the cash and burn the liability. Reconciling these two opposing desires requires strict, automated priority rules embedded deep within your order management architecture.

You cannot rely on human agents to navigate this logic during a high-volume peak season. If you are migrating to a new returns platform, assessing how the platform's API handles split-tender logic is arguably the most critical technical due diligence you will perform. It is the difference between a clean ledger and an unmanageable mess of reconciliation errors.

Prioritizing the refund waterfall

To solve the mixed-tender problem, engineering teams must build a refund waterfall. This is a strict hierarchy that dictates which payment gateway receives funds first during a partial return. The goal is always to protect cash flow by prioritizing non-withdrawable instruments over hard currency.

The standard hierarchy should always execute in this order: Store Credit / Gift Cards → BNPL balances → Primary Credit Cards. If the return value exceeds the amount paid by the first tier, the remainder spills over into the next tier. This ensures that you are never inadvertently cashing out promotional value.

A refund accidentally sent to a burned gift card is a customer service ticket you will never easily close.
Payment InstrumentRefund PriorityFinancial RationaleSystem Action
Store Credit / Gift CardPriority 1 (Highest)Retains cash, clears liabilityRestores balance to code
Buy Now, Pay LaterPriority 2Minimizes consumer loan interestTriggers BNPL API reduction
Credit / Debit CardPriority 3Hard cash outflowRefunds via payment gateway
Cash on Delivery (COD)Priority 4 (Lowest)Requires manual bank transferIssues store credit default

The table above outlines the optimal financial flow. By strictly adhering to this logic through a robust returns API integration, you eliminate the guesswork. The system calculates the exact fractions and fires the correct webhooks to the respective payment providers.

The BNPL complication in partial refunds

Buy Now, Pay Later services introduce a specific layer of complexity. When a shopper finances a cart, the contract is between them and the BNPL provider. If they make a partial return, the refund does not go into their bank account; it reduces their outstanding loan principal.

If your returns portal delays the notification to the BNPL provider, the shopper might be forced to make an installment payment on an item they have already shipped back. This creates immediate, aggressive support tickets. As detailed in our analysis of who eats the BNPL refund timing gap, automating the refund trigger at the first carrier scan (Instant Credit logic) is the most effective way to eliminate this friction. The BNPL ledger updates before the next installment is drawn.

Furthermore, merchants must be aware of how their platform handles fixed transaction fees from these providers. A partial return often does not result in a prorated fee refund from the BNPL gateway, meaning the merchant absorbs the full cost of the original multi-item transaction.

Handling prorated discounts

Split payments are heavily complicated by order-level discounts. If a shopper uses a "€20 off orders over €100" coupon, buys two €60 items, and returns one, they have broken the condition of the promotion. Their retained cart value is now only €60.

If the API simply refunds the line-item value (€60), the shopper has successfully cheated the system, keeping the remaining item for €40 without meeting the threshold. Your legal_basis routing rules must be programmed to automatically recalculate the cart value against the original promotional criteria. In this scenario, the refund must be dynamically adjusted to €40, effectively revoking the discount on the retained item.

  • Always distribute order-level percentage discounts across all line items proportionally.
  • Recalculate fixed-amount threshold discounts if a partial return breaks the qualifying rule.
  • Clearly display the exact prorated refund amount in the returns portal before the user confirms the action.

The final verdict on payment routing

Handling partial returns across multiple payment methods is fundamentally an architectural challenge. When merchants attempt to solve it manually, they lose money through calculation errors and lose customers through frustrating delays and misrouted funds.

To build a scalable architecture, rely on headless commerce returns principles. Decouple the return initiation from the payment execution, build a strict refund waterfall, and let your automated routing rules dictate the flow of funds. Precision in reverse payments is the ultimate hallmark of a mature e-commerce operation.

How should I refund an order paid with both a gift card and a credit card?

You should always use a refund waterfall strategy. Refund the gift card or store credit balance first, up to the maximum amount originally charged to it. Only if the return value exceeds the gift card portion should the remainder be refunded to the credit card.

What happens to a BNPL installment plan during a partial return?

When a partial return is processed, the refund amount is sent directly to the Buy Now, Pay Later provider. The provider then applies this amount to the shopper's outstanding balance, usually reducing the final installment payments or lowering the overall principal.

How do you calculate refunds when a threshold discount code was used?

If a partial return drops the total retained order value below the discount's qualifying threshold, the refund must be adjusted. The system should recalculate the cart as if the discount never existed, deducting the previously applied discount from the final refund amount.

Can I force a customer to take store credit for a split-payment return?

Generally, consumer protection laws require you to refund the customer using the original payment methods. While you can offer incentives (like a 110% bonus) to encourage them to accept store credit for the entire amount, you cannot usually force it if they paid with cash or card.

See it on your own returns.

Start free