Callback

A payment request on Soisy can take different statuses.
In addition to receiving status updates via email, you can receive update notifications as POST calls using thecallbackUrl parameter in the call for order creation. This parameter should contain the valid URL of a resource on your server.

The content is sent in the form application/x-www-form-urlencoded.
The content of the call is as follows:

[
    "eventId": {eventId},
    "eventMessage": {eventMessage},
    "eventDate": {date},
    "orderToken": {token},
    "orderReference": {orderReference}
]

The {token} will give you the Soisy reference identifying the payment, while {orderReference} is your internal reference code, which you sent us in the API call. {eventId} and {eventMessage} will contain the following values:

Status eventId eventMessage Description
Request approved LoanWasApproved loan approved Financing approved
Request completed RequestCompleted waiting for verification The user uploaded his documents and signed the contracts
Financing Pending LoanWasVerified waiting for disbursement The user has been verified
Funded LoanWasDisbursed payment received Payment has been made
Cancelled UserWasRejected documents check KO The customer's documents were refused, so the payment was not successful
Cancelled UserWasRejected payment failed Payment was not successful

Testing

You can check how to test these callbacks on your own in the Sandbox and Testing page.

If you need Soisy's customer support to test your callbacks, please be sure to communicate your order token for the order your want to test.
Soisy's customer support take care of many urgent requests. Therefore contact the support if you're experiencing a technical roadblock.