On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/credentials/developer/ctv/rest/credentials/credentials-intro/credentials-matrix.md)  
Filter  
FILTER BY TAG

Transaction-Specific Fields {#credentials-matrix}
=================================================

To make an authorization request into a credentialed transaction, you must include additional fields that inform `Cybersource` to either store the customer's payment information for future use, or to use an already stored card-on-file for the payment. This section describes the additional required fields that create an initial and subsequent credentialed transaction.

Initial Transactions
--------------------

For an initial transaction, include these fields with a standard authorization request:

[processingInformation.authorizationOptions. initiator. credentialStoredOnFile](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-initiator-cof.md "")
:
Set the value to `true`.

[processingInformation. authorizationOptions. initiator. merchantInitiatedTransaction.reason](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-initiator-mit-reason.md "")
:
Some processors and card types require a reason code when storing payment credentials.

[processingInformation. authorizationOptions. initiator. type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-initiator-type.md "")
:
Set the value to `customer`.

[processingInformation. commerceIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-commerce-ind.md "")
:
Set to one of these possible values:

    * `internet`: Online transaction.
    * `MOTO`: Mail order/telephone order transaction.
    * A payer authentication value.  
      See [Payer Authentication Values](/docs/cybs/en-us/credentials/developer/ctv/rest/credentials/credentials-ref-info-intro/credentials-ref-info-payerauth.md "").
    {#credentials-matrix_ul_ejm_5rv_yhc}

{#credentials-matrix_dl_jjm_5rv_yhc}

```
{
  "processingInformation": {
    "commerceIndicator": "internet",
    "authorizationOptions": {
      "initiator": {
        "type": "customer",
        "credentialStoredOnFile": true,
        "merchantInitiatedTransaction": {
          "reason": "7"
        }
      }
    }
  }
}        
```

When you receive the initial transaction response, save the transaction identifier, which is located in the id field. You need the transaction identifier for subsequent transactions. If you are using the Token Management Service (TMS), `Cybersource` stores the transaction identifier for you.  
This table shows the fields required for each type of CIT and initial transaction.  
![](/content/dam/documentation/cybs/en-us/topics/payments-processing/card-processing/credentials/images/cred-matrix-cit-rest-600x340.svg/jcr:content/renditions/original)

Subsequent Transactions
-----------------------

For a subsequent transaction, include these fields with a standard authorization request:

processingInformation.authorizationOptions. initiator. merchantInitiatedTransaction. previousTransactionID
:
* American Express: Set the value to the transaction ID from the original transaction.
* Discover: Set the value to the transaction ID from the original transaction.
* Visa: set the value to the last successful transaction ID.

[processingInformation. authorizationOptions. initiator. merchantInitiatedTransaction.reason](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-initiator-mit-reason.md "")
:
Some processors and card types require a reason code when you use stored payment credentials.

[processingInformation. authorizationOptions. initiator. storedCredentialUsed](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-initiator-sc-used.md "")
:
Set the value to `true`.

[processingInformation. authorizationOptions. initiator. type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-initiator-type.md "")
:
Set the value to `merchant` for MIT transactions.

[processingInformation. commerceIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-commerce-ind.md "")
:
Set to one of these possible values:

    * `install`: Installment payment
    * `internet`: E-commerce order
    * `MOTO`: Mail order or telephone order
    * `recurring`: Recurring payment
    * A payer authentication value.  
      See [Payer Authentication Values](/docs/cybs/en-us/credentials/developer/ctv/rest/credentials/credentials-ref-info-intro/credentials-ref-info-payerauth.md "").
    {#credentials-matrix_ul_drx_ds1_zhc}

{#credentials-matrix_dl_crx_ds1_zhc}

```
{
  "processingInformation": {
    "commerceIndicator": "internet",
    "authorizationOptions": {
      "initiator": {
        "type": "merchant",
        "storedCredentialUsed": true,
        "merchantInitiatedTransaction": {
          "reason": "7",
          "previousTransactionId": "123456789123"
        }
      }
    }
  }
}        
```

{#credentials-matrix_codeblock_sx1_gyb_tvb}  
This table shows the values for subsequent authorization fields.  
![](/content/dam/documentation/cybs/en-us/topics/payments-processing/card-processing/credentials/images/cred-matrix-mit-rest-600x390.svg/jcr:content/renditions/original)  
RELATED TO THIS PAGE