Capture adjustment lets you modify the amount on a previously captured card transaction before it’s settled. This is useful when the final charge changes after capture, like in hospitality, fuel, or car rental scenarios.

By adjusting the capture instead of creating new transactions, you can reduce declines and avoid multiple holds on the cardholder’s funds, improving the overall customer experience.

When to Use Capture Adjustment

• Pricing Corrections: An incorrect amount is captured due to a manual or POS entry error.
• Fee Adjustments: Shipping, service, or convenience fees are added or removed after capture creation.
• Pre-Settlement Fixes: An error is identified before the batch is closed and funds are settled.

Note: You need to specify the entire new capture amount—not just the difference.

Adjust Capture (Industry Example: Shipping & Fulfillment)

A merchant captures $180 for an order and includes a shipping fee by mistake. Before the batch is closed, the merchant realizes the shipping charge of $15 should not have been applied. The capture is adjusted to $165, and the batch is later closed with the corrected amount.

📘

Capture can not be adjusted once it has moved to SETTLED status. The Capture must be in APPROVED status and its associated Batch is in OPEN status. So, before attempting an adjustment -

• Use GET /checkout/v3/payment/{id} endpoint to verify that the payment is in APPROVED status; OR
• Use GET /checkout/v3/batch/{id}?echo=true endpoint to verify the batch is in OPEN status.

How it Works

1. To adjust a capture, make a PUT request to /checkout/v3/payment/{id} endpoint with a request body that includes:

   Parameter	Description
   tenderType	Set to CARD for card transactions.
   paymentToken	Secure payment token for the payment you want to adjust.
   amount	New total amount (in US currency units). Can be higher or lower than the previously captured sum.
   merchantId	Merchant location ID.

2. Once the payment request is submitted, our system performs a series of system-level validations before sending the transaction to the card network. These validations check for:

   1. Missing or invalid required fields
   2. Incorrect parameter formats or values
   3. Merchant configuration or permission issues. If any validation fails, the request is rejected immediately, and an error response is returned. You must correct the issue and resubmit the request. For a complete list of validation errors and how to resolve them, refer to the System Error Codes guide.

3. If all system-level validations pass, our system sends the updated amount to the issuer and re-authorizes the payment. Use the GET /checkout/v3/payment/{id} endpoint to confirm the updated capture. The response includes:

   1. amount: New amount as specified in the adjust request.
   2. status: Current status of the payment. You’ll also receive the result in a webhook.

4. Monitor the Adjust Payment webhook to track the final outcome of the capture adjustment. You can store the id and paymentToken to:

   1. Retrieve updated payment details later.
   2. Void the payment, if needed.
   3. Issue partial or full refunds.

If the card has insufficient funds, the network returns a Declined status with the response:

"responseStatus": "Decline - Insufficient funds"