Passa al contenuto principale
In questa pagina

Usa questo catalogo per trovare le operazioni migrate dalla precedente documentazione dell’API DEUNA. La matrice di migrazione rappresenta una sola volta ogni metodo e percorso pubblicato, escludendo le altre rotte dell’API Gateway.

Inventario degli endpoint pubblicati#

Questo inventario viene generato dalla configurazione effettiva dell’API Gateway ed è limitato dalla matrice di migrazione verificata. Usa i filtri per identificare chi deve chiamare un’operazione, quale servizio ne è responsabile, quale autorizzazione supporta e quali header il gateway accetta o inoltra.

Il catalogo include solo le operazioni del backend del merchant e delle applicazioni cliente già presenti nella precedente documentazione pubblica dell’API. Sono escluse le operazioni interne di Admin, di gestione, dei partner, di callback dei provider e le altre operazioni del gateway.

Le rotte seguenti /transactions/webhooks/ ricevono eventi del processore all'interno di DEUNA e non sono endpoint di integrazione per il merchant. Quando un provider richiede la configurazione di una callback lato merchant, l'URL e i passaggi di configurazione si trovano nella guida di connessione di quel provider—ad esempio, la callback di stato del pagamento Stripe OXXO. Utilizza DEUNA webhooks per le notifiche consegnate al proprio backend.

Inventario verificato delle API pubblicate56 operazioni pubblicate

Generato dalle operazioni effettive dell’API Gateway mappate dalla precedente documentazione pubblica.

Backend del merchant · server to server 42Applicazione cliente · utente verso server 14
Visualizzazione di 56 operazioni su 56
Backend del merchant · server to serverDa usare da un backend affidabile del merchant per ordini, pagamenti e flussi operativi.42
GET/cards/bin/{bin}
Cards and vaultBackend del merchant · server to server

Recuperare Bin

Dominio
Cards and vault
Servizio responsabile
Card metadata
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
X-Api-KeyX-Merchant-Id
Prova
Esempio cURL
GET/merchants/checkout/themes
CheckoutBackend del merchant · server to server

Elencare o recuperare Themes

Dominio
Checkout
Servizio responsabile
Checkout configuration
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
POST/merchants/checkout/themes
CheckoutBackend del merchant · server to server

Creare Themes

Dominio
Checkout
Servizio responsabile
Checkout configuration
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
DELETE/merchants/checkout/themes/{theme_id}
CheckoutBackend del merchant · server to server

Eliminare Themes

Dominio
Checkout
Servizio responsabile
Checkout configuration
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
PATCH/merchants/checkout/themes/{theme_id}
CheckoutBackend del merchant · server to server

Aggiornare Themes

Dominio
Checkout
Servizio responsabile
Checkout configuration
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
GET/merchants/orders
OrdersBackend del merchant · server to server

Elencare o recuperare Orders

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
POST/merchants/orders
OrdersBackend del merchant · server to server

Creare Orders

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Idempotency-KeyX-Prediction-Id
Prova
Esempio cURL
GET/merchants/orders/{order_token}
OrdersBackend del merchant · server to server

Recuperare Orders

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
AuthorizationX-Api-Keyx-merchant-id
Prova
Esempio cURL
PATCH/merchants/orders/{order_token}
OrdersBackend del merchant · server to server

Aggiornare Orders

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
POST/merchants/orders/{order_token}/expire
OrdersBackend del merchant · server to server

Eseguire Expire per Orders

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
GET/merchants/orders/{order_token}/payments-methods
OrdersBackend del merchant · server to server

Elencare o recuperare Payments Methods

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata o token Bearer, in base al flusso
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Store-Code
Prova
Esempio cURL
POST/merchants/orders/{order_token}/transactions/verify
OrdersBackend del merchant · server to server

Eseguire Verify per Transactions

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata o token Bearer, in base al flusso
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Merchant-IDX-Store-Code
Prova
Esempio cURL
POST/merchants/orders/{order_token}/void
OrdersBackend del merchant · server to server

Eseguire Void per Orders

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/merchants/transactions/orders/{order_token}/installments
OrdersBackend del merchant · server to server

Elencare o recuperare Installments

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata o token Bearer, in base al flusso
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Merchant-IDX-Prediction-Id
Prova
Esempio cURL
POST/v2/merchants/orders/{order_token}/capture
OrdersBackend del merchant · server to server

Acquisire Payment

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
POST/v2/merchants/orders/{order_token}/refund
OrdersBackend del merchant · server to server

Creare Refund

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
POST/v2/merchants/orders/purchase
OrdersBackend del merchant · server to server

Creare Payment

Dominio
Orders
Servizio responsabile
Orders and checkout
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata convalidata; l’header Bearer utente viene inoltrato quando presente
Header accettati o inoltrati
AuthorizationCookieUser-AgentX-Api-KeyX-Device-IdX-Merchant-IDX-Prediction-IdX-Session-IdX-Store-Code
Prova
Esempio cURL
POST/merchants/payment-links
Payment linksBackend del merchant · server to server

Creare Payment Links

Dominio
Payment links
Servizio responsabile
Payment links
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/merchants/payment-links/{payment_link_id}
Payment linksBackend del merchant · server to server

Recuperare Payment Links

Dominio
Payment links
Servizio responsabile
Payment links
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/merchants/payment-links/{payment_link_id}/orders
Payment linksBackend del merchant · server to server

Elencare o recuperare Orders

Dominio
Payment links
Servizio responsabile
Payment links
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/merchants/payment-links/all
Payment linksBackend del merchant · server to server

Elencare o recuperare All

Dominio
Payment links
Servizio responsabile
Payment links
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/merchants/stores/payments-methods
PaymentsBackend del merchant · server to server

Elencare o recuperare Payments Methods

Dominio
Payments
Servizio responsabile
Payments
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
X-Idempotency-KeyX-Merchant-IdX-Prediction-IdX-Store-Code
Prova
Esempio cURL
GET/transactions/payments-methods
PaymentsBackend del merchant · server to server

Elencare o recuperare Payments Methods

Dominio
Payments
Servizio responsabile
Payments
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/merchants/installments/plans/{installment_plan_option_id}
SubscriptionsBackend del merchant · server to server

Recuperare Plans

Dominio
Subscriptions
Servizio responsabile
Installments
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
X-Api-Key
Prova
Esempio cURL
GET/subscriptions
SubscriptionsBackend del merchant · server to server

Elencare o recuperare Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/subscriptions
SubscriptionsBackend del merchant · server to server

Creare Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
GET/subscriptions/{id}
SubscriptionsBackend del merchant · server to server

Recuperare Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
PATCH/subscriptions/{id}
SubscriptionsBackend del merchant · server to server

Aggiornare Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/subscriptions/{id}/cancel
SubscriptionsBackend del merchant · server to server

Eseguire Cancel per Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
PATCH/subscriptions/{id}/cards
SubscriptionsBackend del merchant · server to server

Aggiornare Cards

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/subscriptions/{id}/external-settlement
SubscriptionsBackend del merchant · server to server

Creare External Settlement

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
GET/subscriptions/{id}/history
SubscriptionsBackend del merchant · server to server

Elencare o recuperare History

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/subscriptions/{id}/pause
SubscriptionsBackend del merchant · server to server

Eseguire Pause per Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/subscriptions/{id}/resume
SubscriptionsBackend del merchant · server to server

Eseguire Resume per Subscriptions

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
GET/subscriptions/plans
SubscriptionsBackend del merchant · server to server

Elencare o recuperare Plans

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/subscriptions/plans
SubscriptionsBackend del merchant · server to server

Creare Plans

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
GET/subscriptions/plans/{id}
SubscriptionsBackend del merchant · server to server

Recuperare Plans

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
PATCH/subscriptions/plans/{id}
SubscriptionsBackend del merchant · server to server

Aggiornare Plans

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
GET/subscriptions/plans/statuses
SubscriptionsBackend del merchant · server to server

Elencare o recuperare Statuses

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
*
Prova
Esempio cURL
GET/subscriptions/statuses
SubscriptionsBackend del merchant · server to server

Elencare o recuperare Statuses

Dominio
Subscriptions
Servizio responsabile
Subscriptions
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
Authorizationx-Api-KeyX-Merchant-ID
Prova
Esempio cURL
POST/users/authorize
Users and identityBackend del merchant · server to server

Eseguire Authorize per Users

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata (`X-Api-Key`)
Header accettati o inoltrati
X-Api-KeyX-Merchant-Id
Prova
Esempio cURL
POST/users/external-authorize
Users and identityBackend del merchant · server to server

Creare External Authorize

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Backend del merchant · server to server
Autorizzazione supportata
Chiave API privata convalidata; l’header Bearer utente viene inoltrato quando presente
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Auth-MessageX-Device-IdX-Merchant-Id
Prova
Esempio cURL
Applicazione cliente · utente verso serverDa usare nei flussi Web o mobili con l’identità e il contesto del dispositivo indicati.14
GET/users/{user_id}/cards
Cards and vaultApplicazione cliente · utente verso server

Elencare o recuperare Cards

Dominio
Cards and vault
Servizio responsabile
Payments
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Merchant-ID
Prova
Esempio cURL
DELETE/users/{user_id}/cards/{card_id}
Cards and vaultApplicazione cliente · utente verso server

Eliminare Cards

Dominio
Cards and vault
Servizio responsabile
Payments
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
Authorization
Prova
Esempio cURL
GET/users/{user_id}/cards/{card_id}
Cards and vaultApplicazione cliente · utente verso server

Recuperare Cards

Dominio
Cards and vault
Servizio responsabile
Payments
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
Authorization
Prova
Esempio cURL
PATCH/users/{user_id}/cards/{card_id}/set-as-default
Cards and vaultApplicazione cliente · utente verso server

Impostare la carta come predefinita

Dominio
Cards and vault
Servizio responsabile
Payments
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Merchant-ID
Prova
Esempio cURL
POST/v2/users/{user_id}/cards
Cards and vaultApplicazione cliente · utente verso server

Creare Cards

Dominio
Cards and vault
Servizio responsabile
Payments
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Merchant-ID
Prova
Esempio cURL
GET/users/{user_id}/addresses
Users and identityApplicazione cliente · utente verso server

Elencare o recuperare Addresses

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Device-IdX-Merchant-Id
Prova
Esempio cURL
POST/users/{user_id}/addresses
Users and identityApplicazione cliente · utente verso server

Creare Addresses

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Device-IdX-Merchant-Id
Prova
Esempio cURL
DELETE/users/{user_id}/addresses/{address_id}
Users and identityApplicazione cliente · utente verso server

Eliminare Addresses

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Device-IdX-Merchant-Id
Prova
Esempio cURL
PATCH/users/{user_id}/addresses/{address_id}
Users and identityApplicazione cliente · utente verso server

Aggiornare Addresses

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Device-IdX-Merchant-Id
Prova
Esempio cURL
POST/users/login
Users and identityApplicazione cliente · utente verso server

Eseguire Login per Users

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Flusso di credenziali pubblico con contesto validato dell’applicazione merchant
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Device-IdX-Merchant-IdX-Qa-Api-KeyX-Recaptcha-TokenX-Session-ID
Prova
Esempio cURL
POST/users/logout
Users and identityApplicazione cliente · utente verso server

Eseguire Logout per Users

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Il Gateway non dichiara un validatore di credenziali; l’accesso dipende dal servizio responsabile o dalla policy di rete
Header accettati o inoltrati
AuthorizationX-Device-IDX-Session-ID
Prova
Esempio cURL
GET/users/me
Users and identityApplicazione cliente · utente verso server

Elencare o recuperare Me

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Token Bearer dell’utente autenticato
Header accettati o inoltrati
AuthorizationX-Device-IdX-Merchant-Id
Prova
Esempio cURL
POST/users/register
Users and identityApplicazione cliente · utente verso server

Eseguire Register per Users

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Chiave API privata o token Bearer, in base al flusso
Header accettati o inoltrati
X-Api-KeyX-Merchant-Id
Prova
Esempio cURL
POST/users/request-code
Users and identityApplicazione cliente · utente verso server

Eseguire Request Code per Users

Dominio
Users and identity
Servizio responsabile
Merchant management
Destinato a
Applicazione cliente · utente verso server
Autorizzazione supportata
Flusso di credenziali pubblico con contesto validato dell’applicazione merchant
Header accettati o inoltrati
AuthorizationX-Api-KeyX-Device-IdX-Merchant-Id
Prova
Esempio cURL

Endpoint di integrazione principali#

Le operazioni seguenti mantengono gli ancoraggi stabili utilizzati dalle guide di integrazione e forniscono un contesto aggiuntivo per i flussi di lavoro dei commercianti più comuni.

API degli ordini#

Crea un ordine

POST /merchants/orders

Crea facoltativamente un ordine prima del pagamento e restituisce il order_token usato dai widget e dalle operazioni di pagamento DEUNA. Le nuove integrazioni dirette possono inviare l’ordine inline a Purchase V2.

L'oggetto richiesto varia in base al tipo di ordine: gli ordini di pagamento e abbonamenti richiedono l'array di articoli, mentre gli ordini di compagnie aeree richiedono informazioni sulla compagnia aerea. Il contratto di base non contrassegna la proprietà di un singolo articolo come universalmente richiesta. Vedi il riferimento del campo articolo e guida del campo verticale.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/orders' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'Content-Type: application/json' \
  --data @request.json

Ottieni un ordine

GET /merchants/orders/{order_token}

Recupera lo stato corrente dell'ordine, del pagamento e dell'elaborazione per un token dell'ordine.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-merchant-id: MERCHANT_ID'

Ottieni i metodi di pagamento per un ordine

GET /merchants/orders/{order_token}/payments-methods

Restituisce i metodi di pagamento disponibili per un ordine specifico e una configurazione del commerciante.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}/payments-methods' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Store-Code: STORE_CODE'

API dei pagamenti#

Creare un pagamento

POST /v2/merchants/orders/purchase

Crea ed elabora un ordine inline nel flusso consigliato con un’unica chiamata oppure elabora un order_token esistente quando l’ordine è stato creato separatamente. Consulta la guida dettagliata alla guida alla richiesta di pagamento.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/purchase' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'Cookie: COOKIE_VALUE' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'X-Session-Id: SESSION_ID' \
  --header 'X-Store-Code: STORE_CODE' \
  --header 'Content-Type: application/json' \
  --data @request.json

Cattura un pagamento

POST /v2/merchants/orders/{order_token}/capture

Cattura tutto o parte di un pagamento autorizzato. Chiamalo dal backend del commerciante solo quando la connessione supporta l'autorizzazione e l'acquisizione separate.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/{order_token}/capture' \
  --header 'Content-Type: application/json' \
  --data @request.json

Annullare un'autorizzazione

POST /merchants/orders/{order_token}/void

Rilascia un'autorizzazione idonea prima dell'acquisizione. Una richiesta sincrona riuscita restituisce HTTP 204 No Content; i flussi dei processori asincroni devono comunque essere tracciati fino al loro stato di pagamento finale.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}/void' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data @request.json

Rimborsare un pagamento

POST /v2/merchants/orders/{order_token}/refund

Crea un rimborso totale o parziale per un pagamento elaborato.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/{order_token}/refund' \
  --header 'Content-Type: application/json' \
  --data @request.json

API di rete utente#

Queste operazioni facoltative supportano l’identità del cliente, gli indirizzi riutilizzabili e gli strumenti di pagamento salvati in modo sicuro. Non sono deprecate, ma non sono prerequisiti per Purchase V2. Le applicazioni web e mobili usano l’autorizzazione del cliente. I backend merchant attendibili usano l’autorizzazione indicata per ogni percorso nell’inventario precedente.

Autenticazione

Registra un utente

POST /users/register

Crea facoltativamente un utente che può autenticarsi e riutilizzare in modo sicuro i dati cliente e i metodi di pagamento salvati.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/register' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Richiedi un OTP

POST /users/request-code

Invia il codice monouso utilizzato dal flusso di autenticazione senza password.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/request-code' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Accedi con una OTP

POST /users/login

Scambia un codice monouso valido per un token di autorizzazione utente.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/login' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'X-Qa-Api-Key: QA_API_KEY_VALUE' \
  --header 'X-Recaptcha-Token: RECAPTCHA_TOKEN_VALUE' \
  --header 'X-Session-ID: SESSION_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Autorizzazione esterna

POST /users/external-authorize

Autentica un utente tramite un flusso di identità gestito dal commerciante.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/external-authorize' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Auth-Message: AUTH_MESSAGE_VALUE' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

Utenti

GET /users/me

Restituisce il profilo dell’utente autenticato quando l’integrazione usa account cliente facoltativi.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/me' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

Indirizzi

GET /users/{user_id}/addresses

Elenca gli indirizzi riutilizzabili associati a un utente. Questa operazione facoltativa non è richiesta prima di Purchase V2.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

POST /users/{user_id}/addresses

Salva facoltativamente un indirizzo per il riutilizzo da parte di un utente autenticato. Un indirizzo può anche essere fornito inline in una richiesta di pagamento.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

PATCH /users/{user_id}/addresses/{address_id}

Aggiorna un indirizzo riutilizzabile esistente. L’inventario mostra l’autorizzazione Bearer e il contesto merchant richiesti da questi percorsi facoltativi.

Esempio cURL
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses/{address_id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Carte

Conserva una carta

POST /v2/users/{user_id}/cards

Tokenizza e archivia una o più carte per un utilizzo futuro. Il corpo della richiesta è un array JSON, anche quando contiene una sola carta. Chiama questo endpoint autorizzato dal cliente con il token Bearer dell’utente e il contesto merchant mostrato nell’inventario generato.

I dati grezzi della carta non devono transitare attraverso i server del merchant, a meno che il merchant non disponga dell’ambito PCI richiesto. Consulta il flusso di vaulting dell’API Cards per la struttura della richiesta, il limite di sicurezza, la risposta di successo e le indicazioni sui nuovi tentativi.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/users/{user_id}/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Quale rotta POST per le carte devo usare?

Solo POST /v2/users/{user_id}/cards fa parte del contratto API Cards esterno attuale. Le altre rotte POST che possono apparire negli inventari del Gateway servono scopi diversi di compatibilità o piattaforma; non sono tre modi intercambiabili per creare una carta.

RottaCosa fa effettivamenteGuida per l'integrazione esterna
POST /v2/users/{user_id}/cardsTokenizza e archivia una o più carte del cliente. Il suo corpo della richiesta è un array, anche quando contiene una sola carta, e la risposta restituisce token DEUNA riutilizzabili card_id values.Usa questa rotta per le nuove integrazioni API Cards autorizzate dal cliente.
POST /users/{user_id}/cardsPreserva il contratto di richiesta legacy v1 a singola carta per le integrazioni esistenti.Rotta di compatibilità; è intenzionalmente esclusa dal catalogo API esterno attuale. Non avviare una nuova integrazione con essa a meno che DEUNA non ti indichi esplicitamente di farlo.
POST /users/{user_id}/cards/{card_id}/tokensAggiunge un token specifico del processore o un risultato di verifica a una carta che esiste già. Non crea una carta del cliente e non sostituisce l'operazione di /v2 vaulting.Operazione gestita dalla piattaforma; è intenzionalmente esclusa dalla documentazione esterna e non deve essere chiamata direttamente a meno che DEUNA non approvi il flusso e il contratto.

:::info Perché una rotta può esistere senza apparire qui L'inventario dell'API Gateway include rotte di compatibilità e rotte gestite dalla piattaforma, oltre ai contratti pubblici per i merchant. La presenza nel Gateway di per sé non rende un'operazione un'API esterna supportata. Il catalogo pubblica solo le operazioni che fanno già parte del riferimento esterno o che hanno l'approvazione esplicita del team proprietario. :::

Elencare le carte memorizzate

GET /users/{user_id}/cards

Restituisce le carte associate all’utente autenticato.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID'

Recuperare una carta memorizzata

GET /users/{user_id}/cards/{card_id}

Restituisce una carta associata all’utente autenticato.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN'

Impostare una carta come predefinita

PATCH /users/{user_id}/cards/{card_id}/set-as-default

Imposta o rimuove la carta salvata selezionata come predefinita dell’utente autenticato. Quando una carta diventa quella predefinita, DEUNA rimuove questo stato dalle altre carte dell’utente. Consulta Impostare una carta come predefinita per il corpo facoltativo della richiesta, la risposta e i passaggi di verifica.

Esempio cURL
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}/set-as-default' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Ottieni informazioni sul BIN della carta

GET /cards/bin/{bin}

Restituisce la rete della carta, l'emittente e i metadati del tipo per un BIN a sei cifre.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/cards/bin/{bin}' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID'

API commerciante#

API Themes

L'API Themes è supportata e non è deprecata. Gestisce configurazioni JSON con nome, in ambito merchant, che possono essere applicate alle esperienze DEUNA Checkout e Widget. Chiama queste operazioni solo da un backend merchant attendibile con la chiave privata X-Api-Key; il servizio Checkout Configuration deriva l'ambito merchant da quella credenziale.

Risorsa Tema

CampoRestituitoCreareAggiornamentoDescrizione
idSì.GeneratoParametro di percorsoUUID del tema generato da DEUNA. Usalo come theme_id per aggiornare ed eliminare.
nameSì.ObbligatorioOpzionale quando config viene fornitoNome univoco per il merchant contenente lettere, numeri o underscore.
configSì.ObbligatorioOpzionale quando name viene fornitoOggetto JSON contenente la configurazione del tema utilizzata dall'esperienza Checkout o Widget.

L'operazione di creazione rifiuta nomi duplicati e applica il numero massimo di temi del servizio Checkout Configuration. Aggiornamento ed eliminazione restituiscono un errore quando theme_id non appartiene a un tema esistente nella configurazione del merchant.

curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/checkout/themes' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "checkout_default",
    "config": {
      "theme": {
        "mainColor": "#1479A8",
        "secondaryColor": "#111827",
        "backgroundColor": "#FFFFFF"
      }
    }
  }'
TemaJSON
{
  "id": "bfcabe59-48c9-4c36-b041-71597478689c",
  "name": "checkout_default",
  "config": {
    "theme": {
      "mainColor": "#1479A8",
      "secondaryColor": "#111827",
      "backgroundColor": "#FFFFFF"
    }
  }
}

L'operazione di elenco restituisce la stessa struttura della risorsa in data[]. Creazione e aggiornamento restituiscono il tema interessato. Eliminazione ha successo con una risposta vuota.

:::nota Schema di configurazione del tema Il servizio valida che config è un oggetto JSON ma non valida le sue chiavi annidate. Usa la struttura di configurazione supportata dalla versione di Checkout o Widget che utilizzerà il tema. Non assumere che un oggetto config dell'API Temi e un oggetto CustomStyle dell'SDK siano intercambiabili. :::

Metodi di pagamento

GET /merchants/stores/payments-methods

Restituisce i metodi di pagamento abilitati per un negozio. Passa il codice negozio nella sezione richiesta X-Store-Code header.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/stores/payments-methods' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'X-Store-Code: STORE_CODE'

POST /merchants/payment-links

Crea un collegamento di pagamento dal backend di un commerciante affidabile.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links' \
  --header 'Content-Type: application/json' \
  --data @request.json

GET /merchants/payment-links/{payment_link_id}

Recupera un collegamento di pagamento e il suo stato attuale.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/{payment_link_id}'

GET /merchants/payment-links/all

Elenca i link di pagamento associati al negozio del merchant autenticato.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/all'

GET /merchants/payment-links/{payment_link_id}/orders

Elenca gli ordini associati a un link di pagamento.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/{payment_link_id}/orders'

voce completa dell’endpoint Guida all'integrazione dei link di pagamento per il flusso end-to-end.

API degli abbonamenti#

Piani

GET /subscriptions/plans

Elenca i piani di abbonamento disponibili per il commerciante autenticato.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/subscriptions/plans' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID'

POST /subscriptions/plans

Crea un piano di abbonamento.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/subscriptions/plans' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Abbonamenti

Elenco abbonamenti

GET /subscriptions

Restituisce gli abbonamenti disponibili al commerciante autenticato.

Esempio cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/subscriptions' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID'

Crea un abbonamento

POST /subscriptions

Crea un abbonamento utilizzando un piano e un metodo di pagamento esistenti.

Esempio cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/subscriptions' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Aggiorna un abbonamento

PATCH /subscriptions/{id}

Aggiorna gli attributi supportati di un abbonamento attivo.

Esempio cURL
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/subscriptions/{id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json