Callback

Una richiesta di pagamento su Soisy può assumere diversi stati.
Oltre a ricevere gli aggiornamenti di stato via email, puoi ricevere le notifiche di aggiornamento come chiamate POST utilizzando il parametro callbackUrl nella chiamata di creazione di un ordine. Questo parametro dovrà contenere l'URL valido di una risorsa su un tuo server.

Il contenuto è inviato in formato application/x-www-form-urlencoded.
Il contenuto della chiamata è il seguente:

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

Il campo {token} ti darà il riferimento Soisy identificativo del pagamento, mentre {orderReference} è il tuo codice di rifermento interno, che ci hai inviato nella chiamata API.
{eventId} e {eventMessage} potranno conterere, a seconda dello stato, i seguenti valori:

Stato Descrizione (per ambiente)
Richiesta approvata
eventId: LoanWasApproved
eventMessage: loan approved
Produzione: Il richiedente ha superato la pre-approvazione automatica dei nostri sistemi nel funnel Soisy e sta proseguendo con l'immissione dei propri dati.

Sandbox: Come in produzione.
In attesa di finanziamento
eventId: LoanWasVerified
eventMessage: waiting for disbursement
Produzione: Il richiedente ha terminato la sua richiesta di pagamento rateale che è stata approvata da un operatore. Il pagamento verrà finanziato.

Sandbox: Richiedere la generazione dell'evento al supporto clienti Soisy.
Finanziato
eventId: LoanWasDisbursed
eventMessage: payment received
Produzione: La richiesta di pagamento rateale viene finanziata definitivamente in un processo che viene eseguito la notte successiva all'evento LoanWasVerified.

Sandbox: Richiedere la generazione dell'evento al supporto clienti Soisy.
Annullato
eventId: UserWasRejected
eventMessage: payment failed
Produzione: La richiesta di pre-approvazione del pagamento rateale è stata rifiutata dai nostri sistemi automatici.

Sandbox: Come in produzione.
Annullato
eventId: UserWasRejected
eventMessage: documents check KO
Produzione: Soisy, dopo le opportune verifiche, ha rifiutato i dati o i documenti relativi al cliente.

Sandbox: Richiedere la generazione dell'evento al supporto clienti Soisy.

Quando sarà il momento di contattare il supporto clienti per richiedere la generazione di un evento in modalità sandbox, assicurarsi di comunicare al supporto il token di ordine identificativo per la richiesta di pagamento interessata.