Passa al contenuto principale
Tutti i sistemi operativiNovitàv1
Accedi
DEUNA API

Riferimento API

Scegli l’operazione API, il modello di autorizzazione e il chiamante corretti per ogni flusso di integrazione DEUNA.

Ultimo aggiornamento: October 2, 2026Raccolta Postman
In questa pagina

La documentazione di riferimento dell’API DEUNA include le operazioni del backend del merchant e delle applicazioni cliente pubblicate nella documentazione precedente. Inizia dal chiamante, non solo dal nome della risorsa, perché il modello di autorizzazione supportato cambia in base alla superficie. Le altre rotte dell’API Gateway sono intenzionalmente escluse da questa documentazione.

Usa la navigazione del riferimento API per consultare le operazioni pubblicate per area di prodotto e risorsa.

Esempi di richieste di ordini e pagamentiCopia richieste complete Purchase V2 e richieste facoltative di creazione dell’ordine per settore.AutenticazioneScegli la credenziale e il modello di autorizzazione corretti per ogni chiamante.Creare il pagamentoEsamina il contratto di pagamento completo e il pannello interattivo di richiesta.API ThemesCrea e gestisci configurazioni di tema Checkout e Widget riutilizzabili.

URL di base#

Utilizzare l'URL di base sandbox durante la costruzione. Passare alla produzione solo dopo aver ricevuto le credenziali di produzione e completare la certificazione.

Sandbox
https://api.sandbox.deuna.io
Produzione
https://api.deuna.io

Scegli la superficie API#

SuperficieChiamata intensaAutorizzazioneUsalo per
backend Merchant · server al serverInfrastrutture mercantili fiduciateChiave API privata in X-Api-Key; X-Store-Code e intestazioni di idempotency dove richiestoOrdini, acquisti, acquisizioni, rimborsi, annullamenti e consultazioni operative
Applicazione del cliente · utente al serverApplicazione Web o mobile di Merchant che agisce per un clientecontesto di applicazione pubblica più utente Authorization: Bearer … dopo il login; mai incorporato una chiave privataAccesso facoltativo, profili e indirizzi riutilizzabili e carte salvate

Autenticazione#

Rivestimento di merce

Inviare la chiave API privata in X-Api-KeyNon nell'intestazione del Bearer. Tenere su un'infrastruttura server di fiducia.

Intestazioni di richiesta server-serverHTTP
X-Api-Key: YOUR_PRIVATE_API_KEY
X-Store-Code: STORE_CODE
X-Idempotency-Key: order_1042-attempt_1
Content-Type: application/json

Cliente autenticato

Invia il token di accesso dell’utente nell’header Bearer. Alcune operazioni di ordine e wallet richiedono anche la chiave dell’applicazione merchant o il contesto del negozio; ogni pagina dell’operazione elenca l’autorizzazione e gli header inoltrati.

Intestazioni di richiesta utente-serverHTTP
Authorization: Bearer USER_ACCESS_TOKEN
X-Api-Key: APPLICATION_API_KEY
X-Store-Code: STORE_CODE
Content-Type: application/json

Vedi Autenticazione per la gestione delle credenziali, le vite token e la rotazione.

Operazioni di backend Merchant#

POST
/merchants/orders
Creare un ordine e ottenere il suo ordine token
GET
/merchants/orders/{order_token}
Recuperare l'ordine corrente e lo stato di pagamento
GET
/merchants/orders/{order_token}/payments-methods
Ottieni i metodi di pagamento disponibili per l'ordine
POST
/v2/merchants/orders/purchase
Creare il pagamento
POST
/v2/merchants/orders/{order_token}/capture
Acquisire un pagamento autorizzato
POST
/v2/merchants/orders/{order_token}/refund
Creare un rimborso completo o parziale
GET
/merchants/checkout/themes
Elenca e gestisci i temi Checkout del merchant

Operazioni di applicazione del cliente#

POST
/users/request-code
Richiedi un codice di login una volta
POST
/users/login
Scambiare un OTP per un token utente
GET
/users/me
Leggi il profilo utente autenticato
GET
/users/{user_id}/cards
Elenca le carte memorizzate per l'utente autenticato
PATCH
/users/{user_id}/cards/{card_id}/set-as-default
Impostare o rimuovere la carta predefinita dell’utente autenticato

Risposte ed errori#

2xxLa richiesta è riuscita.
4xxL'autenticazione, le autorizzazioni, i dati di stato o di richiesta devono cambiare. Ispezionare il codice di errore restituito.
5xxDEUNA o un fornitore non sono riusciti. Ripristinare solo quando l'operazione è idempotent, utilizzando la stessa chiave di idempotency.

Sfoglia l'elenco completo in Codici di errore.

Versione per il percorso#

Utilizzare ogni percorso esattamente come pubblicato. API Gateway espone frequentemente percorsi canonici senza un interno /api/v1 Prefisso. Un segmento di versione come /v2 è incluso solo quando fa parte della rotta pubblica mostrata nel catalogo. I cambiamenti compatibili con i back-wards sono elencati nella Cambiare il linguaggio.