Transaction indicators
Particularly for card payments you have to set the transactionIndicator in the transaction’s data to indicate the type of CoF or recurring transaction.
Single
A SINGLE transaction indicates a customer triggered one-off payment where the customer is present. If withRegister is sent with true, the payment instrument is stored for future use in card-on-file payments.
We highly recommend enabling 3-D Secure authentication for liability shift when the customer is present and initiating the transaction. This provides an additional layer of security and can help protect against chargebacks. 3-D Secure authentication might be required in certain regions, for example, refer to EBA’s PSD2 SCA announcement.
SINGLE is the default transaction indicator for Debit and Preauthorize transactions where withRegister is false.
Example : cart checkout.
First card-on-file
A FIRST-CARDONFILE transaction indicates a customer triggered one-off payment where the customer is present. This is equivalent to SINGLE where withRegister is true, except the token is not stored in the IXOPAY platform’s vault but by the PCI-compliant merchant themselves.
We highly recommend enabling 3-D Secure authentication for liability shift when the customer is present and initiating the transaction. This provides an additional layer of security and can help protect against chargebacks. 3-D Secure authentication might be required in certain regions, for example, refer to EBA’s PSD2 SCA announcement.
This transaction indicator only applies to the PCI transaction API and merchants that are PCI certified.
Example : cart checkout.
Card-on-file
A CARDONFILE transaction indicates a customer triggered one-off card-on-file payment where the customer is present. That means, the payment instrument was previously stored.
We highly recommend enabling 3-D Secure authentication for liability shift when the customer is present and initiating the transaction. This provides an additional layer of security and can help protect against chargebacks. 3-D Secure authentication might be required in certain regions, for example, refer to EBA’s PSD2 SCA announcement.
Example : cart checkout.
Merchant-initiated card-on-file
A CARDONFILE-MERCHANT-INITIATED transaction indicates an unscheduled merchant-initiated card-on-file payment.
Example : automated balance top-up.
Initial
An INITIAL transaction indicates the first transaction in a recurring series of scheduled payments, where the customer is present.
INITIAL and RECURRING indicators should only be used if the merchant intends to process payments at regular, consistent intervals, and always for the same amount.
We highly recommend enabling 3-D Secure authentication for liability shift when the customer is present and initiating the transaction. This provides an additional layer of security and can help protect against chargebacks. 3-D Secure authentication might be required in certain regions, for example, refer to EBA’s PSD2 SCA announcement.
INITIAL is the default transaction indicator for Debit and Preauthorize transactions where withRegister is true.
If you want to use a stored payment instrument (card-on-file) for recurring transactions, you can use this transaction indicator and send the uuid of the initial SINGLE transaction that registered the card as a referenceTransaction.
Example : customer subscribes to a monthly service.
Recurring
A RECURRING transaction indicates a subsequent card-on-file transaction in a recurring series of payments, where the customer is not present.
@@CALLOUT_OPEN|note|Transaction criteria@@
INITIAL and RECURRING indicators should only be used if the merchant intends to process payments at regular, consistent intervals, and always for the same amount.
Example : Monthly billing of a subscribed service.
Mail or telephone order
A MOTO transaction indicates the card data is entered by a service agent and not by the customer themselves.
Example : call-center purchase.