Incremental Transaction
An incremental authorization is used to increase the total amount
authorized for a payment if the initial authorization does not cover the total cost of
goods and services. An incremental transaction is an additional amount to the original
authorization. The final authorized total includes amounts for both the initial and the
incremental authorizations. Incremental transactions are limited to certain merchant
categories, such as rental, lodging, transit, amusement parks, restaurants, and
bars.
This section describes how to process an incremental transaction using these payment
types:
Merchant-Initiated Incremental Transaction with PAN
An incremental authorization is used to increase the total amount authorized for a payment if the initial authorization does not cover the total cost of goods and services. An incremental transaction is an additional amount to the original authorization. The final authorized total includes amounts for both the initial and the incremental authorizations. Incremental transactions are limited to certain merchant categories, such as rental, lodging, transit, amusement parks, restaurants, and bars.
To create an incremental transaction using the
Business Center
, choose one of these options:
-
Account Top Up
-
No Show
Supported Card Types
These are the supported card types for processing credentialed transactions:
-
American Express
-
Mastercard
-
Visa
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
Merchant-Initiated Incremental Transaction with
TMS
TMS
An incremental authorization is used to increase the total amount authorized for a payment if the initial authorization does not cover the total cost of goods and services. An incremental transaction is an additional amount to the original authorization. The final authorized total includes amounts for both the initial and the incremental authorizations. Incremental transactions are limited to certain merchant categories, such as rental, lodging, transit, amusement parks, restaurants, and bars.
This section describes how to process a merchant-initiated incremental transaction using these
TMS
token types:
-
Customer
-
Customer tokens store one or more customer payment instrument tokens and shipping address tokens.
-
Including a customer token eliminates the need to include billing information, card information, and the previous transaction's ID.
-
"paymentInformation": { "customer": { "id": "07C9CA98022DA498E063A2598D0AA400" } }
-
For more information about thisTMStoken type, see Customer Tokens in theToken Management ServiceDeveloper Guide
-
Payment Instrument
-
Payment instrument tokens store an instrument identifier token, card information, and billing information. Payment instruments are not linked to a customer token.
-
Including a payment instrument eliminates the need to include billing information, card information, and the previous transaction's ID.
-
"paymentInformation": { "paymentInstrument": { "id": "07CA24EF20F9E2C9E063A2598D0A8565" } }
-
For more information about thisTMStoken type, see Payment Instrument Token in theToken Management ServiceDeveloper Guide
-
Instrument Identifier
-
Instrument identifier tokens store only a PAN. Including an instrument identifier eliminates the need to include a PAN and the previous transaction's ID.
-
"paymentInformation": { "instrumentIdentifier": { "id": "7010000000016241111" } }
-
For more information about thisTMStoken type, see Instrument Identifier Token in theToken Management ServiceDeveloper Guide
To create an incremental transaction using the
Business Center
, choose one of these options:
-
Account Top Up
-
No Show
Supported Card Types
These are the supported card types for processing credentialed transactions:
-
American Express
-
Mastercard
-
Visa
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments