StoredCredentialTransactionInformation

Bundle containing necessary information required for CIT / MIT payments.

JSON representation
{

  // Union field stored_credential_option can be only one of the following:
  "customerInitiated": {
    object (CustomerInitiatedTransactionInformation)
  },
  "merchantInitiated": {
    object (MerchantInitiatedTransactionInformation)
  }
  // End of list of possible types for union field stored_credential_option.
}
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:
customerInitiated

object (CustomerInitiatedTransactionInformation)

The customer initiated the payment.

merchantInitiated

object (MerchantInitiatedTransactionInformation)

The merchant initiated the payment.

CustomerInitiatedTransactionInformation

Contains information necessary to process a CIT.

JSON representation
{
  "transactionIntentClassification": enum (TransactionIntentClassification),
  "instrumentStorageType": enum (InstrumentStorageType)
}
Fields
transactionIntentClassification

enum (TransactionIntentClassification)

REQUIRED: Defines the intent for initiating the stored credential or merchant initiated transaction.

instrumentStorageType

enum (InstrumentStorageType)

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 (TransactionIntentClassification),
  "instrumentStorageType": enum (InstrumentStorageType),

  // Union field previous_transaction_option can be only one of the following:
  "previousTransactionInformation": {
    object (PreviousTransactionInformation)
  },
  "legacyMerchantTransaction": boolean
  // End of list of possible types for union field previous_transaction_option.
}
Fields
transactionIntentClassification

enum (TransactionIntentClassification)

REQUIRED: Defines the intent for initiating the stored credential or merchant initiated transaction.

instrumentStorageType

enum (InstrumentStorageType)

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:
previousTransactionInformation

object (PreviousTransactionInformation)

Information related to previous payments made with these stored credentials.

legacyMerchantTransaction

boolean

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
storedCredentialTransactionId

string

OPTIONAL: The transaction id from a previous stored-credential transaction, if available. Sometimes known as authorization trace identifier.

originalTransactionAmount

string (Int64Value format)

OPTIONAL: The authorization amount associated with the transaction id supplied in storedCredentialTransactionId.