- JSON representation
- CustomerInitiatedTransactionInformation
- TransactionIntentClassification
- InstrumentStorageType
- MerchantInitiatedTransactionInformation
- PreviousTransactionInformation
Bundle containing necessary information required for CIT / MIT payments.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field stored_credential_option . REQUIRED: The information needed to process a stored credential transaction. stored_credential_option can be only one of the following: |
|
customer |
The customer initiated the payment. |
merchant |
The merchant initiated the payment. |
CustomerInitiatedTransactionInformation
Contains information necessary to process a CIT.
JSON representation |
---|
{ "transactionIntentClassification": enum ( |
Fields | |
---|---|
transaction |
REQUIRED: Defines the intent for initiating the stored credential or merchant initiated transaction. |
instrument |
REQUIRED: Indicates the manner in which the payment instrument is stored for future use. |
TransactionIntentClassification
Defines the intent for initiating the stored credential or merchant initiated transaction.
Enums | |
---|---|
TRANSACTION_INTENT_CLASSIFICATION_UNKNOWN |
Do not ever set this default value! |
INSTALLMENT |
A transaction in a series of transactions that uses a stored credential and that represents a cardholder agreement for the merchant to initiate one or more future transactions over a period for a single purchase of goods or services. |
RECURRING |
A transaction in a series of transactions that use a stored credential and that are processed at fixed, regular intervals (not to exceed one year between transactions), representing cardholder agreement for the merchant to initiate future transactions for the purchase of goods or services provided at regular intervals. |
UNSCHEDULED |
A transaction using a stored credential for a fixed or variable amount that does not occur on a scheduled or regularly occurring transaction date, where the cardholder has provided consent for the merchant to initiate one or more future transactions. |
INCREMENTAL |
Incremental authorizations can be used to increase the total amount authorized if the authorized amount is insufficient. |
RESUBMISSION |
A merchant performs a resubmission in cases where it requested an authorization, but received a decline due to insufficient funds after it has already delivered the goods or services to the cardholder. |
REAUTHORIZATION |
A merchant initiates a reauthorization when the completion or fulfillment of the original order or service extends beyond the authorization validity limit. |
DELAYED_CHARGES |
Delayed charge transaction is performed to process a supplemental account charge after original services have been rendered and respective payment has been processed. |
NO_SHOW |
Cardholders can use their Visa cards to make a guaranteed reservation with certain merchant segments. A guaranteed reservation ensures that the reservation will be honored and allows a merchant to perform a no-show transaction to charge the cardholder a penalty according to the merchant's cancellation policy. |
InstrumentStorageType
Defines the transaction relative to storing the instrument for future use.
Enums | |
---|---|
INSTRUMENT_STORAGE_TYPE_UNKNOWN |
Do not ever set this default value! |
FIRST_TRANSACTION |
First usage (payment or verification) of the card/token on file which may be followed by additional transactions. |
STORED |
Subsequent usage of a stored card/token. |
MerchantInitiatedTransactionInformation
Contains information necessary to process an MIT.
JSON representation |
---|
{ "transactionIntentClassification": enum ( |
Fields | |
---|---|
transaction |
REQUIRED: Defines the intent for initiating the stored credential or merchant initiated transaction. |
instrument |
REQUIRED: Indicates the manner in which the payment instrument is stored for future use. |
Union field previous_transaction_option . REQUIRED: Information about previous transactions needed to process the payment. previous_transaction_option can be only one of the following: |
|
previous |
Information related to previous payments made with these stored credentials. |
legacy |
No stored credential transaction id is available for this payment. This is used when the recurring payment needs to be migrated to the stored credential framework. The payment integrator should attempt to obtain a stored credential transaction id for use in subsequent Merchant Initiated Transactions. |
PreviousTransactionInformation
Contains information about previous payments used to verify the current transaction
JSON representation |
---|
{ "storedCredentialTransactionId": string, "originalTransactionAmount": string } |
Fields | |
---|---|
stored |
OPTIONAL: The transaction id from a previous stored-credential transaction, if available. Sometimes known as authorization trace identifier. |
original |
OPTIONAL: The authorization amount associated with the transaction id supplied in storedCredentialTransactionId. |