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.

These are the supported card types for incremental authorizations:

American Express

Discover

Mastercard

Visa

Endpoint

Production:

PATCH https://nabgateway-api.nab.com.au/pts/v2/payments/{id}

Test:

PATCH https://nabgateway-api-test.nab.com.au/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

Optional Field for Processing an Incremental Authorization

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

clientReferenceInformation.transactionId

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"
}