Skip to main content

Customer-initiated transactions

Customer-initiated transactions are transactions initiated by the customer, whether in-person, online, or through other means, such as telephone or mobile. These transactions can be in the form of a one-time purchase, a recurring payment, or a pre-authorized payment. They are transactions in which the customer is present and actively participating.

While most transactions we are familiar with are customer-initiated, there are also merchant initiated transactions. These are initiated by the merchant using stored payment information.

The merchant has to choose the correct transaction type based on the nature of the payment. It is important to select the correct transaction type to avoid issues such as chargebacks or declines due to incorrect information. Ensuring the correct transaction type is chosen can help merchants avoid fraud and ensure a smoother payment experience for both themselves and their customers.

Integration options

Customer-initiated transactions can be integrated into a website using either hosted payment pages or payment.js. Hosted payment pages are web pages that are hosted by the IXOPAY platform and allow customers to enter their payment information. payment.js is a client-side library that merchants can use to create custom payment forms on their website.

  • Debit: A payment transaction where the funds are immediately transferred.
  • Preauthorize: A payment transaction where the merchant reserves the amount of the payment on the customer's card but does not transfer funds until a capture API call is made. If the merchant needs to void the transaction, the funds will be deallocated. For details, see our article on saving payment information.
  • Incremental authorization: A follow-up payment transaction to a previous preauhtorize transaction that increases or prolongs the authorized amount on the customer's card. For details, see our article on saving payment information.

Transaction indicators

To indicate what kind of payment a merchant is planning, a transaction indicator is used. You should supply a transactionIndicator when creating a new transaction, if a merchant does not provide a transaction indicator, a default value will be used. For debit and preauthorize transactions, the default transaction indicator is SINGLE, which indicates a one-time payment. For register transactions, the default transaction indicator is INITIAL, which indicates the first of a series of payments.

The transaction indicators that are relevant to customer-initiated transactions include:

Transaction indicatorDescription
SINGLEIndicates a one-time payment.
INITIALThe first of a series of payments, such as for a subscription service.
CARDONFILEUsed when the customer has previously stored their payment instrument, such as a credit card, and is now using it again to perform a one-time payment.
FIRST-CARDONFILEIndicates a one-time payment, but the PCI-compliant merchant stores the payment instrument of the customer themselves.

When using a CARDONFILE transaction indicator, the merchant has to collect 3DS browser data and send it to the IXOPAY platform.

For a full list of transaction indicators, please see our separate transaction indicators page in the reference.

Strong customer authentication and 3-D Secure

When processing payments, merchants must comply with Strong Customer Authentication (SCA) regulations. SCA is a European Union regulatory requirement designed to make online payments more secure. Merchants must use SCA for customer-initiated payments, but for merchant-initiated payments, SCA is not required.

For more information on 3-D Secure, please see our separate 3-D Secure guide.

Saving payment information

During a customer-initiated transaction, the option to save payment information is available. This means that the credit card data is stored securely in the PCI-compliant vault of IXOPAY.

For details on how to save payment information, see our dedicated guide Saving payment information.