Manage Payments - ReAuth

This guide focuses on sending a Re-Authorization (ReAuth) request to receive a more recent authcode.

This action is used to refresh the authorization associated with a transaction when too much time has passed since the transaction was authorized. The card issuer might return the withheld funds to the cardholder if the payment is not captured within a certain amount of time. Therefore, the transaction needs to get a more recent authcode.

Additionally, you can use a Re-Authorization request in cases where the amount you want to deduct from the customer's card is less than the originally authorized amount or if you need to reauthorize a transaction that was reversed in error.

The main things to know about ReAuth:

• The amount submitted in a Re-Authorization request must be less than 200% of the original pre-authorization amouount (ignoring any increments).
• Availability in production depends on your live configuration.

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

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

In this step, we reauthorize a transaction to receive a more recent authcode.

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.

ReAuths 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.