API - ordine
API - ordine
Lo step di integrazione “Ordine” ti consente di creare o recuperare una risorsa ordine su Soisy che corrisponde proprio ad un ordine fatto sulla tua piattaforma e-commerce. Dovrai modificare la schermata di checkout della tua piattaforma, mostrando Soisy come nuovo metodo di pagamento:
- Quando un utente sceglie il metodo di pagamento Soisy, non dovrai fare altro che: comunicarci i dati dell’ordine;
- Reindirizzare l’utente alla nostra webapp o proseguire con l’integrazione
Per il primo passaggio basta chiamare l’API Crea un Ordine, fornendoci alcuni dati dell’ordine (totale ordine, numero di rate, indirizzo email, …). Questa chiamata API ti restituirà un token, che identificherà l’ordine univocamente all’interno della nostra piattaforma, e che dovrai memorizzare sulla tua piattaforma.
Reindirizza l’utente alla nostra webapp..
A questo punto potrai reindirizzare l’utente alla nostra webapp, utilizzando la seguente URL:
Sandbox: http://shop.sandbox.soisy.it/{shopId}#/loan-request?token={token}
Produzione: https://shop.soisy.it/{shopId}#/loan-request?token={token}
oppure puoi, più semplicemente, utilizzare il parametro returnUrl che ti è stato restituito nella chiamata di creazione di un ordine insieme al token.
La nostra webapp riconoscerà il token fornito e mostrerà al tuo cliente alcune schermate personalizzate per raccogliere tutti i dati necessari alla richiesta. Nel seguente video potrai vedere l’intero flusso di richiesta Soisy dalla nostra webapp:
Da questo punto in poi l’utente continuerà sulla nostra webapp. Il cliente dovrà confermarci i dati che ci hai fornito, mentre dovrà inserire ex-novo altri dati. Il completamento dell’ordine sulla nostra webapp dura mediamente 3 minuti.
Per approfondire il tema del redirect puoi andare nella pagina dedicata al flusso dell’integrazione via API.
Verrai avvisato da alcune email e, se lo vorrai, da alcune chiamate callback man mano che l’utente andrà avanti nella richiesta. Trovi tutte le informazioni sulle callback nella pagina dedicata. Inoltre troverai tutti gli ordini creati via API anche nella tua Dashboard Partner.
