Integration Guidelines - Italian partner
This page contains information about Italian integration for web. For specific cases, technical elements provided by Cofidis must be preferred over the information contains hereafter. Each API section contain a Swagger with full detail about the method.
Please find bellow the list of the available API for Italian integration
| API method | Global Integration | Specific Integration | Comment for specific integration |
|---|---|---|---|
| initialize | x | x | |
| sendPayment | x | ||
| confirm | x | x | Initialize must always be set to “Immediate” |
| cancel | x | ||
| validate | x | x | |
| refund | x | x | No partial refund is allowed |
| getStatus | x | x | |
| connect | x | ||
| simulateOffer | x | ||
| updateStatus | x | UpdateStatus allow for early abandon |
Web
Following diagram details the internal states taken by the API. It covers Web integrations for Italy only. A full list of possible States is also available in API getStatus.
API State Diagram for WEB applications. It is specific to Italian partners.
Please find bellow recommended processes. If your specific needs fall outside of the presented process, please contact Cofidis.
Standard integration
- Call API initialize and redirect customer to Cofidis Journey as soon as you receive the redirection link
- Within 50 minutes after redirection to the journey
- If the journey ended successfully, you will go to “pending” state waiting for acceptation by Codifis Italy
- While state is still “pending” you can abort the transaction by calling updateStatus
- When receiving state “to_confirm” from the notification, call API confirm
- confirm return contains the new state, if it’s “validated” the transaction is Financed, it’s the final state you need to reach for a valid transaction
- If you need to refund the whole transaction
- You might call getStatus to get the available amounts
- Call API refund with full amount
- New status will be “refunded”