On This Page
Incremental Authorization
Incremental authorizations are merchant-initiated transactions with no cardholder present at the time of the transaction. They allow you to add additional products and services to an
to append an original pre-authorization to add products and services.
The incremental authorization has these limitations:
- Original transaction must be a pre-authorization.
- Must be in the same currency as the original pre-authorization.
- Maximum of 100 incremental authorizations per transaction, in addition to the initial authorization.
- Interchange optimization is not supported.
- Split shipments are not supported.
These are the supported card types for incremental authorizations:
- Mastercard
- Visa
Endpoint
Production:
PATCH
https://api.cybersource.com
/pts/v2/payments/{id}
Test:
PATCH
https://apitest.cybersource.com
/pts/v2/payments/{id}
The is the transaction ID returned in the
original authorization response.
{id}
Required Fields for an Incremental Authorization
- orderInformation.amountDetails.additionalAmount
Optional Field for Processing an Incremental Authorization
You can use this optional field to
include your transaction ID for an incremental authorization.
REST Example: Incremental Authorization
Request
{ "clientReferenceInformation": { "code": "33557799" }, "orderInformation" : { "amountDetails" : { "additionalAmount": "10.00", "currency" : "CNY" } } }
Response to a Successful Request
{ "_links" : { "authReversal" : { "method" : "POST", "href" : "/pts/v2/payments/6479624584536070903093/reversals" }, "self" : { "method" : "GET", "href" : "/pts/v2/payments/6479624584536070903093" }, "capture" : { "method" : "POST", "href" : "/pts/v2/payments/6479624584536070903093/captures" } }, "clientReferenceInformation" : { "code" : "33557799" }, "id" : "6479624584536070903093", "orderInformation" : { "amountDetails" : { "totalAmount" : "20.00", "authorizedAmount" : "10.00", "currency" : "CNY" } }, "processorInformation" : { "approvalCode" : "005290", "responseCode" : "00" }, "reconciliationId" : "610005247521", "status" : "AUTHORIZED" }