API Initialize

The initialize API is used to create a transaction, and to redirect the customer to the Cofidis Journey portal along with the relevant information (assuming the customer acceptance of the legal notices).

The merchantTransactionID and merchantTransactionDate fields, are used to identify the specific transaction of a merchant. The pair merchantTransactionId/merchantTransactionDate must be unique for a given merchant. It will be used in the other API calls to act on the associated transaction.

Mandatory fields might change depending of the product you sell, your Cofidis Point of contact can give you the list.

“captureMode” field value has two settings modifying behavior of other calls.

  • "captureMode":"Validate" which need a call to both confirm and validate to finalize a financing;
  • "captureMode":"Immediate" which only needs a call to confirm to finalize a financing;
ResponseCode ResponseMessage Comment
000 API Success
001 Transaction Date is not today Check field “merchantTransactionDate”, date YYYYMMDD must be date of the day, within CEST time
002 Transaction Key already used Pair “merchantTransactionDate”, “merchantTransactionId” already used