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:

American Express

Discover

Mastercard

Visa

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.

Required Fields for an Incremental Authorization

clientReferenceInformation.code
orderInformation.amountDetails.totalAmount
orderInformation.amountDetails.currency

Related Information

API field reference guide for the REST API

Country-Specific Required Field for an Incremental Authorization

Use this country-specific required field for an incremental authorization.

Argentina

merchantInformation.transactionLocalDateTime: Required in Argentina when the time zone is not included in your account. Otherwise, this field is optional.

Related Information

API field reference guide for the REST API

Optional Field for Processing an Incremental Authorization

You can use this optional field to include your transaction ID for an incremental authorization.

clientReferenceInformation.transactionId

Related Information

API field reference guide for the REST API

REST Example: Incremental Authorization

Request

{
  "clientReferenceInformation": {
    "code": "33557799"
  },
  "orderInformation" : {
    "amountDetails" : {
      "totalAmount": "105.00",
      "currency" : "USD"
    }
  }
  "merchantInformation": {
    "transactionLocalDateTime": "20261002080000"
  }
}

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" : {
      "authorizedAmount" : "105.00",
      "currency" : "USD"
    }
  },
  "paymentAccountInformation" : {
    "card" : {
      "type" : "001"
    }
  },
  "paymentInformation" : {
    "tokenizedCard" : {
      "type" : "001"
    },
    "card" : {
      "type" : "001"
    }
  },
  "processorInformation" : {
    "systemTraceAuditNumber" : "819203",
    "approvalCode" : "831000",
    "cardVerification" : {
      "resultCodeRaw" : "M",
      "resultCode" : "M"
    },
    "merchantAdvice" : {
      "code" : "01",
      "codeRaw" : "M001"
    },
    "responseDetails" : "ABC",
    "networkTransactionId" : "016153570198200",
    "retrievalReferenceNumber" : "208115819203",
    "consumerAuthenticationResponse" : {
      "code" : "2",
      "codeRaw" : "2"
    },
    "transactionId" : "016153570198200",
    "responseCode" : "00",
    "avs" : {
      "code" : "Y",
      "codeRaw" : "Y"
    }
  },
  "reconciliationId" : "6479624584536070903093",
  "status" : "AUTHORIZED",
  "submitTimeUtc" : "2026-03-22T15:20:58Z"
}