Adjustments

Change the amount of your payment, before batch closure.

Adjust allows you to modify the previous transaction amount, either by increasing or decreasing it. Adjustments help reduce declines and improve customer experience by avoiding multiple holds on funds.

Note: You need to specify the entire new amount and not the difference.


When to Use Adjustments

Use adjustments when the transaction amount changes due to:

  • Tips or service charges added later
  • Inventory or pricing updates
  • Partial order fulfillment
  • Final settlement differences

Types of Adjustments

Depending on the transaction stage, adjustments can be performed at different levels:


Choose the Right Adjustment

The correct adjustment type depends on the stage of the transaction at the moment you need to change the amount.

Business scenarioTransaction stageUse this
Restaurant adds tip to closed-out checkSale completed (auth + capture in one step), batch openSale Adjustment
Promo code applied after checkoutSale completed, batch openSale Adjustment
Tax recalculation error caught post-saleSale completed, batch openSale Adjustment
Gas pump final total less than pre-authAuthorized, not yet capturedAuthorization Adjustment
Hotel guest adds spa charges before check-outAuthorized, not yet capturedAuthorization Adjustment
Car rental extra-day add-onAuthorized, not yet capturedAuthorization Adjustment
Shipping fee included by mistake in captureCaptured, batch openCapture Adjustment
POS entry error caught after captureCaptured, batch openCapture Adjustment
Customer cancels before batch closesAuthorized or capturedVoid — not an adjustment
Customer cancels after batch settlesSettledRefund — not an adjustment
📘

Why not just refund? Adjustments happen before the batch closes, so no funds have moved yet and the transaction is updated in place. Refunds happen after settlement, creating a second transaction with its own interchange cost and a multi-day settlement window for the customer. Prefer an adjustment whenever the batch is still open.


Adjust vs. Void vs. Refund

flowchart LR
    A([Transaction<br/>created]) --> B{Current<br/>stage?}
    B -->|Auth only| C([Authorization<br/>Adjustment])
    B -->|Sale<br/>batch open| D([Sale<br/>Adjustment])
    B -->|Captured<br/>batch open| E([Capture<br/>Adjustment])
    B -->|Cancel entirely<br/>pre-settle| F([Void])
    B -->|Batch settled| G([Refund])
    style C fill:#E1F5FE,stroke:#0288D1,stroke-width:2px
    style D fill:#E1F5FE,stroke:#0288D1,stroke-width:2px
    style E fill:#E1F5FE,stroke:#0288D1,stroke-width:2px
    style F fill:#FFF3E0,stroke:#F57C00,stroke-width:2px
    style G fill:#F3E5F5,stroke:#7B1FA2,stroke-width:2px
  • Adjustments change the amount on a transaction in place (PUT /checkout/v3/payment/{id} with paymentType: Adjustment).
  • Voids cancel a transaction entirely before settlement.
  • Refunds move money back to the customer after settlement.

All three adjustment types are the same API call; only the stage of the payment differs (authorized, sale, or captured). Adjustments and voids require the batch to still be Open; a refund is the only option once the batch has settled.


Did this page help you?
.readme-logo { display: none !important; }