API diretta
Costruire un'esperienza di pagamento di proprietà dei commercianti con le API del server DEUNA.
In questa pagina
Controlla l’interfaccia e coordina i pagamenti dal tuo backend.
Crea il percorso cliente nella tua applicazione e usa le API DEUNA per operazioni di pagamento, utenti, carte e orchestrazione.
- Interfaccia
- Frontend e backend gestiti dal merchant
- Modello di distribuzione
- API server-to-server con supporto client dove necessario
- Ideale per
- Team che richiedono il massimo controllo del prodotto
Integra le soluzioni di pagamento e checkout DEUNA nella tua applicazione tramite API Direct/Headless.
I servizi API DEUNA sono organizzati intorno al principio REST.
Ciò significa che i servizi:
- Sono orientate alle risorse.
- Ricevi e restituisci risposte JSON.
- Utilizzare i codici di risposta HTTP standard.
- Autentica con gli standard REST
- Utilizzare i verbi standard REST GET, POST, PATCH, FETCH e DELETE.
Autenticazione#
DEUNA crea API Keys private e pubbliche per la tua applicazione.
Utilizzare le chiavi API per autenticare come un commerciante per l'API. APY Keys sono creati durante la creazione del tuo account Sandbox e possono essere forniti anche da un TPM DEUNA. È possibile creare più chiavi API associate allo stesso account.
I gettoni JWT vengono utilizzati per le chiamate che creano pagamenti, memorizzano le carte e operano con i dati dell'utente.
Idempotence#
Le API DEUNA supportano l'idempotence, permettendoti di riprovare le richieste alle nostre API senza preoccuparsi di generare accidentalmente la stessa operazione due volte.
DEUNA salva il codice di risposta e il carico utile della prima richiesta per ogni valore del idempotency key.
DEUNA salva il codice di risposta e il carico utile della prima richiesta per ogni valore della chiave di idempotency.
Le chiavi di Idempotency sono utilizzate per il verbo HTTP: POST.
Ambienti#
L'ambiente API DEUNA ha due ambienti indipendenti l'uno dall'altro:
Sandbox
Sandbox è l'ambiente utilizzato per la prova.
L'ambiente sandbox contiene i collegamenti ai vari fornitori di pagamenti e frodi che mirano ai rispettivi ambienti di prova.
Utilizzare l'ambiente sandbox per eseguire i test con i dati disponibili per ogni fornitore
URL: https://api.sandbox.deuna.io
Produzione
La produzione è l'ambiente utilizzato per elaborare le transazioni effettive nell'ambiente di produzione.
È altamente raccomandato per testare ogni integrazione nell'ambiente sandbox prima di spostarlo alla produzione.
URL: https://api.deuna.io
Raccolta Postman#
DEUNA ha la seguente collezione pubblica Postman per integrazioni e test più convenienti: DEUNA Collezione Postman.
Gestione utente#
DEUNA consente la creazione di utenti per una migliore gestione e struttura di tutte le risorse e servizi:
- Crea utenti.
- Ottieni utenti.
- Elimina gli utenti.
- Associati ha memorizzato le carte con gli utenti.
- Pagamenti associati agli utenti.
- Gli indirizzi associati agli utenti.
Carte di deposito#
DEUNA offre funzionalità di archiviazione di carte per memorizzare le carte precedentemente memorizzate e fornire una migliore esperienza per i vostri clienti.
DEUNA genera un token unico per ogni carta creata che può essere memorizzata senza alcun rischio.
Pagamenti di processo#
Elaborare pagamenti dai tuoi utenti attraverso una singola integrazione utilizzando il nostro motore di pagamento e frode che consente di orchestrare i pagamenti in tempo reale.
I pagamenti di processo con più fornitori di pagamento e frode, mantenendo la stessa struttura di risposta e la standardizzazione dei codici di errore tra i fornitori.
3DS#
DEUNA supporta il flusso 3DS in tutte le sue integrazioni.
Webhook#
DEUNA comunica gli aggiornamenti sulle modifiche dello stato dell'ordine tramite webhook.
I Webhooks sono consigliati per comunicare eventi asincroni dai metodi di pagamento. Il risultato di approvazione o rifiuto viene comunicato utilizzando questo standard.
Con nuove tecnologie come 3DS, anche le transazioni con carte diventano asincroni, ed è importante ascoltare gli eventi di ordine una volta che l'utente completa l'autenticazione con la propria banca e riceve uno stato di pagamento finale.