Before you begin

This guide assumes that you know how to:

Accept payments with Cetelem

Prepare the API

Cetelem requires the following data to process a payment successfully. Pass the following data in the client session, or in the payment request (for manual payment creation).

Parameter NameRequiredDescription
3-letter currency code in ISO 4217 format, e.g. USD for US dollars
  1. order
Details of the line items of the order
  1. metadata
  2. monext_contracts

The e-commerce contract code or number

  1. customer

Buyer's email address

  1. customer

The mobile number of the buyer

  1. metadata

Title of civility, See the table of values

  1. cutomer
  2. billingAddress
  1. customer
  2. billingAddress
  1. customer
  2. billingAddress
  1. customer
  2. billingAddress
  1. customer
  2. billingAddress
  1. customer
  2. billingAddress
  1. customer
  2. shippingAddress
  1. customer
  2. shippingAddress
  1. customer
  2. shippingAddress
  1. customer
  2. shippingAddress
  1. customer
  2. shippingAddress
  1. customer
  2. shippingAddress

Prepare the SDK for payments

Handle payment method

Cetelem requires instance of Redirect Manager in order to be presented to the user:

1
const manager = await headless.createPaymentMethodManager('MONEXT_CETELEM')
typescript
copy

MONEXT_CETELEM must be returned as PaymentMethod.type in the onAvailablePaymentMethodsLoad callback.

When the user has selected the payment method, call the start function. This function automatically:

  • opens a popup to present a loading indicator, then the payment method web page
  • shows an overlay on top of your page that prompts the user to focus on the popup
123
myButton.addEventListener('click', () => {    manager.start()})
typescript
copy

This code is intended solely for illustrative purposes. As many redirect payment methods share a common approach, it is recommended to centralize the implementation of these methods within your codebase. For a practical demonstration of how to achieve this, please refer to the guide on how to handle payment methods with redirect.

Go live

You don’t need to do anything particular to go live — just make sure to use production credentials.