Incremental Authorization

Use the information in this section to process a lodging incremental authorization. You can add products and services to an existing authorization by using an incremental authorization.
The incremental authorization service has these limitations:
  • Maximum of 100 incremental authorizations per transaction, in addition to the initial authorization.
  • Interchange optimization is not supported.

Endpoint

Production:
PATCH
https://api.cybersource.com
/pts/v2/payments/
{id}
Test:
PATCH
https://apitest.cybersource.com
/pts/v2/payments/
{id}
The
{id}
 is the transaction ID returned in the original authorization response.

Incremental Authorization Service Scenario

This sequence is an example of how an incremental authorization can be used:
  1. The customer reserves a room for two nights at a cost of 200.00 per night. You request an authorization for 400.00. This initial authorization request is approved.
  2. The customer orders dinner through room service the first night. You request an incremental authorization of 50.00 for the dinner.
  3. The customer decides to stay an extra night. You request an incremental authorization of 200.00 for the additional night.
  4. The customer uses items from the mini-bar. The cost of these mini-bar items is 50.00. You request an incremental authorization of 50.00.
  5. When the customer ends their stay and checks out, they sign a receipt for 700.00, which is the total of all costs incurred.
  6. You request a capture for 700.00.

REST Example: Incremental Authorization

Light Dark
Request
1234567891011121314151617181920212223
{"clientReferenceInformation": {
        "code": "TestCode123",
        "comments": "Incremental Auth CP",
        "partner": {
            "thirdPartyCertificationNumber": "123456789012",
            "developerId": "AssignedDevID",
            "solutionId": "AssignedSolutionID"
        }
    },
    "processingInformation": {
        "authorizationOptions": {
            "initiator": {
                "type": "merchant",
                "storedCredentialUsed": "true"
            }
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "USD"
        }
    }}
Response to a Successful Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344
{"_links": {
        "authReversal": {
            "method": "POST",
            "href": "/pts/v2/payments/7334466205036952804953/reversals"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/7334466205036952804953"
        },
        "capture": {
            "method": "POST",
            "href": "/pts/v2/payments/7334466205036952804953/captures"
        }
    },
    "clientReferenceInformation": {
        "comments": "Incremental Auth CP",
        "code": "TestCode123",
        "partner": {
            "developerId": "AssignedDevID",
            "solutionId": "AssignedSolutionID"
        }
    },
    "id": "7334466205036952804953",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "600.00",
            "authorizedAmount": "100.00",
            "currency": "USD"
        }
    },
    "paymentInformation": {
        "accountFeatures": {
            "category": "A"
        }
    },
    "processorInformation": {
        "systemTraceAuditNumber": "023821",
        "approvalCode": "012921",
        "transactionId": "304341034201726",
        "responseCode": "00"
    },
    "reconciliationId": "214",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2025-12-06T00:58:10Z"}