On This Page

Introduction to Credentialed Transactions

Credentialed transactions, also known as credentials‑on‑file (COF) or card‑on‑file transactions, are payments that either store a customer’s payment credentials for future use or use previously stored credentials to complete a transaction. All COF transactions begin with a customer-initiated transaction, in which the customer actively participates, such as a card‑present purchase, online checkout, or use of a stored credential.

Benefits of Credentialed Transactions

Merchants following the stored credentials framework experience these benefits:

Better visibility into transaction risk.

Improved authorization success rates.

A smoother customer experience.

Fewer disputes and customer complaints.

Use of Real Time Visa Account Updater for fresher card details.

Types of Credentialed Transactions

There are several types of credentialed transactions:

Customer-initiated transaction (CIT):
During a CIT, customers can elect to have their credentials stored for future CITs or for merchant‑initiated transactions (MITs).

Merchant-initiated transaction (MIT):
A MIT is processed without the customer’s active involvement and include these transactions:

Industry practice transaction:
This MIT is performed as a subsequent transaction to a CIT because the initial transaction could not be completed in one transaction. Not every industry practice transaction involves a stored credential. If a stored credential is used only for one transaction, that transaction is not considered a credentialed transaction.

Industry Practice Transactions

Industry practice transactions are MITs performed as follow‑on actions to a previous CIT. Although not all of them require stored credentials, repeated use of credentials qualifies them as COF transactions.

These industry practice transactions and industry examples are available with your processor:

Delayed charges: Used to add charges after the initial transaction is complete. Examples: hotels (minibar, damages), car rentals (tolls), travel (post-trip charges), and health and wellness add-ons.

Incremental charges: Used when an amount exceeds the original authorization. Examples: extending hotel stays, adding rental car insurance, restaurant gratuities, and event upgrades.

Reauthorizations: Used when an authorization expires before fulfillment. Examples: long hotel stays, extended rental agreements, multi-week equipment rentals, and delayed subscription boxes.

Resubmissions: Used when a previous authorization attempt fails. Examples: utility auto-pay retries, telecom billing, insurance premiums, and online membership renewals.

No-shows: Used when a customer fails to appear for a reserved service for these industries: hotels, rentals, healthcare missed appointments, and restaurant reservation deposits.

`Smartpay Fuse Portal` Transactions

You can create an industry practice transaction in the Smartpay Fuse Portal by requesting a new authorization. Go to the Transaction Management section and confirm that the new authorization is a MIT. Choose one of these reason types for the authorization:

Account Top Up

Delayed Charges

No Show

Reauthorization

Resubmission

This process requires you to have already stored the customer's credentials from a previous customer-initiated transaction. For more information on storing a customer's credentials in the Smartpay Fuse Portal, see Customer-Initiated Transactions with Credentials on File.

To create an incremental transaction in the Smartpay Fuse Portal, choose one of these options:

Account Top Up

No Show

Transaction-Specific Fields

To make an authorization request into a credentialed transaction, you must include additional fields that inform Barclays 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: Set the value to
true
.
processingInformation. authorizationOptions. initiator. merchantInitiatedTransaction.reason: Some processors and card types require a reason code when storing payment credentials.
processingInformation. authorizationOptions. initiator. type: Set the value to
customer
.
processingInformation. commerceIndicator: Set to one of these possible values:
internet
: Online transaction.
MOTO
: Mail order/telephone order transaction.
A payer authentication value.
See Payer Authentication Values.

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

field. You need the transaction identifier for subsequent transactions. If you are using the

Token Management Service

(

TMS

), Barclays stores the transaction identifier for you.

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: Some processors and card types require a reason code when you use stored payment credentials.
processingInformation. authorizationOptions. initiator. storedCredentialUsed: Set the value to
true
.
processingInformation. authorizationOptions. initiator. type: Set the value to
merchant
for MIT transactions.
processingInformation. commerceIndicator: 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.

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