Passa al contenuto principale
In questa pagina

Gli SDK DEUNA rendono le esperienze di pagamento all'interno di applicazioni web e mobili. Scegli la guida per la piattaforma corrispondente all'applicazione che distribuisci, quindi utilizza il metodo del prodotto supportato da tale SDK.

Scegli una piattaforma e un flusso#

CapacitàWeb WebAndroidiOSReazione nativo
Pagamento WidgetinitPaymentWidgetinitPaymentWidgetinitPaymentWidgetinitPaymentWidget
Completamento del processo di pagamentoNon espostoinitCheckoutinitCheckoutNon esposto
Archiviazione dei pagamenti e Click to PayinitElementsinitElementsinitElementsinitElements
Continua con 3DS o un'altra azione in sospesoinitNextActioninitNextActioninitNextActioninitNextAction
Esperienza per voucherinitVoucherWidgetinitVoucherWidgetinitVoucherinitVoucherWidget
Foglio wallet nativoApple Pay e Google PayGoogle PayPaga di AppleApple Pay e Google Pay
Finestra modale e presentazione integrataSì.Sì.Sì.Sì.

Flusso di integrazione#

Diagramma di sequenza
1Web or mobile app2Merchant backend3DEUNARequest a checkout sessionCreate order with private API keyReturn order tokenReturn order token onlyInitialize SDK with public API keyOpen the selected experienceSuccess, error, close, and lifecyclecallbacksSigned webhook with final state
Commerciante o clienteDEUNA
  1. Creare l'ordine sul tuo backend con un privato Chiave API.
  2. Restituisci solo il token dell'ordine di breve durata all'applicazione.
  3. Inizializza l'SDK con la chiave API pubblica e l'ambiente corrispondenti.
  4. Apri l'esperienza appropriata e gestisci i callback di successo, errore, chiusura e ciclo di vita.
  5. Utilizza il callback per aggiornare l'interfaccia, ma utilizza un webhook verificato come fonte di verità per l'esecuzione.

Regole di ciclo di vita comuni#

  • Mantieni attivo un'istanza dell'SDK per tutta la durata dell'esperienza attiva.
  • Considera onSuccess come un segnale dell'interfaccia utente; conferma lo stato finale di pagamento sul tuo backend.
  • Maniglia onError e onClosed separatamente. La chiusura di un widget da parte di un cliente non è necessariamente un fallimento del pagamento.
  • Rilascia il widget quando termina lo schermo o il flusso di proprietà. Utilizza close() per un flusso attivo e il meccanismo di smaltimento specifico della piattaforma per una vista integrata.
  • Chiamata initNextAction solo con il token dell'ordine per un ordine che DEUNA segnala come richiedente un'ulteriore azione.
  • Verifica la disponibilità del wallet nativo prima di rendere un pulsante Apple Pay o Google Pay di proprietà del merchant.

Codice ufficiale#

I repository mantenuti sono la fonte di verità per le versioni dei pacchetti, le versioni delle piattaforme supportate, le note di rilascio ed esempi funzionanti.