Manage Payments - Adjust

This guide focuses on sending an adjustment to add a tip to a card-present transaction.

Tips, or gratuities, are common in North American restaurants and other service industries. They allow payers to add an additional amount to the transaction for excellent service provided by the merchant’s employees.

The main things to know about making an adjustment:

• When processing adjustments, the status of the transaction, such as Pre-Authorized, does not change.
• You can change the same transaction data (amount and EMV data) during a Capture request. However, that request will change the status of the transaction — for example, moving a transaction from Pre-Authorized to Captured.

Before starting the steps in this guide, you must do the following:

• Get registered
• Create an app (generate keys)
• Create an access token

To successfully send the command, you need the trn_id from the initial transaction. Adjustments can’t be made after the transaction is funded.

Sample request

Sample response

  {
    "id": "TRN_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",
    "time_created": "2026-05-03T21:23:39.718Z",
    "type": "SALE",
    "status": "CAPTURED",
    "amount": "11099",
    "currency": "USD",
    "country": "US",
    "reference": "becf9f3e-4d33-459c-8ed2-0c4affc9555e",
    "batch_id": "BAT_234234234",
    "payment_method": {
        "result": "string",
        "message": "string",
        "card": {
            "authcode": "string",
            "brand_reference": "string"
        }
    },
    "action": {
        "id": "ACT_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",
        "type": "ADJUST",
        "time_created": "2026-05-03T21:23:39.718Z",
        "result_code": "SUCCESS",
        "app_id": "uzFr7t4VOqxdLDI44hHmXIjHtOOE8d",
        "app_name": "my_lovely_app"
    }
}

To get a deeper understanding of this function, we recommend that you use our provided integration references for both API and SDK integrations. For the full detailed API specification, see the API Explorer.

Adjustments are available for testing in our free Sandbox environment for registered users of this developer portal. Use our resources below to start testing different scenarios.