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;
-
Using the field processMod, you can specify how the API will be used.
- "processMod": "Redirect" for a standard redirection towards Cofidis Journey
- "processMod": "API" for using RTU Mode and displaying the journey in Iframes
| 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 |