Per cominciare

🥳 Benvenuto nella sezione dedicata alla documentazione delle API e dei plugin Soisy.

Se sei interessato ai benefici che Soisy può apportare alla tua azienda, consulta le pagine dedicate ai partner sul nostro sito.

Se invece stai iniziando a capire come integrare i tuoi servizi con la nostra piattaforma sei nel posto giusto!
Continua a leggere questa documentazione e diventerai un Soisy API Ninja in meno di un ciclo di clock.

Sì, ma come funziona a grandi linee? 🤔

Soisy sarà un nuovo metodo di pagamento per il tuo e-commerce. Sì, hai capito bene, proprio come PayPal o Stripe.
Immagina un tuo cliente sul tuo e-commerce: dopo aver confermato il carrello, deve scegliere il metodo di pagamento.

Carrello

Selezionando "Soisy" potrà rateizzare il totale del suo carrello diventando nostro richiedente e proseguire così il flusso di richiesta con noi 😄

Flusso di integrazione Soisy

Il flusso di richiesta di pagamento rateale Soisy si divide in 4 step, di cui i primi due di sono integrabili via API, mentre per l’ultimo è obbligatorio fare redirect alla nostra webapp:

  1. Creazione di un ordine: è l'integrazione più semplice ed è quella che il 95% dei nostri partner utilizza. Fatta questa singola chiamata, effettuano il redirect all'URL che noi comunichiamo in risposta alla chiamata e il resto lo farà il cliente finale nel nostro funnel.

  2. Richiesta pagamento rateale e approvazione pagamento è l’integrazione più profonda ed è composta da due chiamate (per un totale di tre chiamate se consideriamo anche la chiamata di creazione ordine effettuata allo step 1). Questo step permette al merchant un'integrazione più avanzata, tenendo il cliente finale nel proprio funnel fino alla valutazione (approvazione o rifiuto) del pagamento rateale.

  3. Caricamento dei documenti personali: a questo punto il redirect al nostro flusso diventa obbligatorio per la conclusione del pagamento rateale (upload documenti e processo KYC).

  4. Firma digitale

Consigliamo sempre ai nostri partner di partire con l'integrazione più semplice (step 1) per poi iterare ed eventualmente procedere allo step 2 dopo aver validato Soisy come metodo di pagamento.

Questo permette al partner di risparmiare tempo e denaro iniziale:

  • Decidi tu quanto effort dedicare allo sviluppo iniziale integrando fino allo step che desideri
  • Puoi offrire ai tuoi clienti un'esperienza simile al pagamento con PayPal: comprare sul tuo e-commerce per poi completare l'acquisto su Soisy
  • Offire un'esperienza di acquisto più trasparente per il tuo brand dando immediatamente riscontro sull'approvazione del pagamento rateale e, nel caso di rifiuto, offrire al cliente un altro metodo di pagamento così che non lasci mai il tuo e-commerce o app.

Nel seguente video potrai vedere l'intero flusso di richiesta Soisy dalla nostra webapp:

Insomma che aspetti a mettere mano al codice 😄 ?

API o plugin? Quale scegliere.

Per farti integrare con Soisy nel modo più semplice possibile, ti offriamo la possibilità di integrarti tramite plugin o via API.

Il plugin lo installi, imposti i giusti parametri e sei pronto per partire. E' un'implementazione plug & play che integra fino allo step dell'ordine.

Le API consentono una libertà di integrazione e personalizzazione maggiori:

  • scegli tu fino a dove integrarti lasciando a noi il resto del lavoro
  • sei tu a personalizzare il funzionamento della tua piattaforma in base al numero di rate e al tasso
  • hai la possibilità di ricevere aggiornamenti di stato sugli ordini e sulle richieste, in tempo reale, attraverso una chiamata callback