API validate
The validate API is used to validate an Authorized transaction and to trigger financing and payment to the partner.
Please note that this API is only available for transactions initiated with the field "captureMode" set to "Validate". Else, the financing is immediately handled by the confirm API call.
The amount sent with this payment must be equal or less than the confirmed amount.
Warning: Only one call to validate is possible for a given transaction. This call must be completed before the end of authorization validity period.
The following validity duration are applied by default:
- For 3X and 4X the call to validate must be made within six days after a call to confirm
- For Loan the call to validate must be done within 30 days after a call to confirm
Please contact Cofidis, if you need longer durations.
A call to this method will trigger the following:
- Initialisation of the customer payment schedule for direct debits
- Validation of the financing and payment to the partner
| ResponseCode | ResponseMessage | Comment |
|---|---|---|
| 000 | API Success | |
| 003 | Transaction Key is not an accepted transaction | |
| 006 | Transaction Key has already been validated | Call already done for this transaction |
| 007 | Transaction Key not in Authorized status | |
| 008 | validateAmount greater than authorizedAmount | validateAmount and authorizedAmount can be found in the responses of cancel, getStatus and confirm |
| 022 | TransactionKey does not exist | The pair “merchantTransactionID”, “merchantTransactionDate” does not exist for this partner |
| 906,914 | Technical error - unable to validate transaction |