Aller au contenu principal
Sur cette page

Utilisez ce catalogue pour retrouver les opérations migrées depuis la précédente référence de l’API DEUNA. La matrice de migration représente chaque méthode et chaque chemin publiés une seule fois tout en excluant les autres routes de l’API Gateway.

Inventaire des endpoints publiés#

Cet inventaire est généré à partir de la configuration effective de l’API Gateway et limité par la matrice de migration vérifiée. Utilisez les filtres pour identifier qui doit appeler une opération, quel service en est responsable, quelle autorisation elle prend en charge et quels en-têtes la passerelle accepte ou transmet.

Le catalogue comprend uniquement les opérations du backend marchand et des applications clientes déjà présentes dans la référence publique précédente de l’API. Les opérations internes d’Admin, de gestion, de partenaires, de callback fournisseur et les autres opérations de la passerelle sont exclues.

Routes ci-dessous /transactions/webhooks/ reçoivent des événements de processeur à l'intérieur de DEUNA et ne sont pas des points de terminaison d'intégration marchand. Lorsqu'un fournisseur nécessite une configuration de rappel côté marchand, l'URL et les étapes de configuration se trouvent dans le guide de connexion de ce fournisseur — par exemple, le rappel de statut de paiement Stripe OXXO. Utilisez Webhooks DEUNA pour les notifications livrées à votre propre backend.

Inventaire vérifié des API publiées56 opérations publiées

Généré à partir des opérations effectives de l’API Gateway mappées depuis la référence publique précédente.

Backend marchand · serveur à serveur 42Application client · utilisateur vers serveur 14
Affichage de 56 opérations sur 56
Backend marchand · serveur à serveurÀ utiliser depuis un backend marchand de confiance pour les commandes, paiements et opérations.42
GET/cards/bin/{bin}
Cards and vaultBackend marchand · serveur à serveur

Récupérer Bin

Domaine
Cards and vault
Service responsable
Card metadata
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
X-Api-KeyX-Merchant-Id
Essayer
Exemple cURL
GET/merchants/checkout/themes
CheckoutBackend marchand · serveur à serveur

Lister ou récupérer Themes

Domaine
Checkout
Service responsable
Checkout configuration
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
POST/merchants/checkout/themes
CheckoutBackend marchand · serveur à serveur

Créer Themes

Domaine
Checkout
Service responsable
Checkout configuration
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
DELETE/merchants/checkout/themes/{theme_id}
CheckoutBackend marchand · serveur à serveur

Supprimer Themes

Domaine
Checkout
Service responsable
Checkout configuration
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
PATCH/merchants/checkout/themes/{theme_id}
CheckoutBackend marchand · serveur à serveur

Mettre à jour Themes

Domaine
Checkout
Service responsable
Checkout configuration
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
GET/merchants/orders
OrdersBackend marchand · serveur à serveur

Lister ou récupérer Orders

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
POST/merchants/orders
OrdersBackend marchand · serveur à serveur

Créer Orders

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Idempotency-KeyX-Prediction-Id
Essayer
Exemple cURL
GET/merchants/orders/{order_token}
OrdersBackend marchand · serveur à serveur

Récupérer Orders

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
AuthorizationX-Api-Keyx-merchant-id
Essayer
Exemple cURL
PATCH/merchants/orders/{order_token}
OrdersBackend marchand · serveur à serveur

Mettre à jour Orders

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
POST/merchants/orders/{order_token}/expire
OrdersBackend marchand · serveur à serveur

Exécuter Expire pour Orders

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
GET/merchants/orders/{order_token}/payments-methods
OrdersBackend marchand · serveur à serveur

Lister ou récupérer Payments Methods

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée ou jeton Bearer, selon le parcours
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Store-Code
Essayer
Exemple cURL
POST/merchants/orders/{order_token}/transactions/verify
OrdersBackend marchand · serveur à serveur

Exécuter Verify pour Transactions

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée ou jeton Bearer, selon le parcours
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Merchant-IDX-Store-Code
Essayer
Exemple cURL
POST/merchants/orders/{order_token}/void
OrdersBackend marchand · serveur à serveur

Exécuter Void pour Orders

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/merchants/transactions/orders/{order_token}/installments
OrdersBackend marchand · serveur à serveur

Lister ou récupérer Installments

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée ou jeton Bearer, selon le parcours
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Merchant-IDX-Prediction-Id
Essayer
Exemple cURL
POST/v2/merchants/orders/{order_token}/capture
OrdersBackend marchand · serveur à serveur

Capturer Payment

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
POST/v2/merchants/orders/{order_token}/refund
OrdersBackend marchand · serveur à serveur

Créer Refund

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
POST/v2/merchants/orders/purchase
OrdersBackend marchand · serveur à serveur

Créer Payment

Domaine
Orders
Service responsable
Orders and checkout
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée validée ; l’en-tête Bearer utilisateur est transmis lorsqu’il est présent
En-têtes acceptés ou transférés
AuthorizationCookieUser-AgentX-Api-KeyX-Device-IdX-Merchant-IDX-Prediction-IdX-Session-IdX-Store-Code
Essayer
Exemple cURL
POST/merchants/payment-links
Payment linksBackend marchand · serveur à serveur

Créer Payment Links

Domaine
Payment links
Service responsable
Payment links
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/merchants/payment-links/{payment_link_id}
Payment linksBackend marchand · serveur à serveur

Récupérer Payment Links

Domaine
Payment links
Service responsable
Payment links
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/merchants/payment-links/{payment_link_id}/orders
Payment linksBackend marchand · serveur à serveur

Lister ou récupérer Orders

Domaine
Payment links
Service responsable
Payment links
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/merchants/payment-links/all
Payment linksBackend marchand · serveur à serveur

Lister ou récupérer All

Domaine
Payment links
Service responsable
Payment links
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/merchants/stores/payments-methods
PaymentsBackend marchand · serveur à serveur

Lister ou récupérer Payments Methods

Domaine
Payments
Service responsable
Payments
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
X-Idempotency-KeyX-Merchant-IdX-Prediction-IdX-Store-Code
Essayer
Exemple cURL
GET/transactions/payments-methods
PaymentsBackend marchand · serveur à serveur

Lister ou récupérer Payments Methods

Domaine
Payments
Service responsable
Payments
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/merchants/installments/plans/{installment_plan_option_id}
SubscriptionsBackend marchand · serveur à serveur

Récupérer Plans

Domaine
Subscriptions
Service responsable
Installments
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
X-Api-Key
Essayer
Exemple cURL
GET/subscriptions
SubscriptionsBackend marchand · serveur à serveur

Lister ou récupérer Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/subscriptions
SubscriptionsBackend marchand · serveur à serveur

Créer Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
GET/subscriptions/{id}
SubscriptionsBackend marchand · serveur à serveur

Récupérer Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
PATCH/subscriptions/{id}
SubscriptionsBackend marchand · serveur à serveur

Mettre à jour Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/subscriptions/{id}/cancel
SubscriptionsBackend marchand · serveur à serveur

Exécuter Cancel pour Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
PATCH/subscriptions/{id}/cards
SubscriptionsBackend marchand · serveur à serveur

Mettre à jour Cards

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/subscriptions/{id}/external-settlement
SubscriptionsBackend marchand · serveur à serveur

Créer External Settlement

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
GET/subscriptions/{id}/history
SubscriptionsBackend marchand · serveur à serveur

Lister ou récupérer History

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/subscriptions/{id}/pause
SubscriptionsBackend marchand · serveur à serveur

Exécuter Pause pour Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/subscriptions/{id}/resume
SubscriptionsBackend marchand · serveur à serveur

Exécuter Resume pour Subscriptions

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
GET/subscriptions/plans
SubscriptionsBackend marchand · serveur à serveur

Lister ou récupérer Plans

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/subscriptions/plans
SubscriptionsBackend marchand · serveur à serveur

Créer Plans

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
GET/subscriptions/plans/{id}
SubscriptionsBackend marchand · serveur à serveur

Récupérer Plans

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
PATCH/subscriptions/plans/{id}
SubscriptionsBackend marchand · serveur à serveur

Mettre à jour Plans

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
GET/subscriptions/plans/statuses
SubscriptionsBackend marchand · serveur à serveur

Lister ou récupérer Statuses

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
*
Essayer
Exemple cURL
GET/subscriptions/statuses
SubscriptionsBackend marchand · serveur à serveur

Lister ou récupérer Statuses

Domaine
Subscriptions
Service responsable
Subscriptions
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
Authorizationx-Api-KeyX-Merchant-ID
Essayer
Exemple cURL
POST/users/authorize
Users and identityBackend marchand · serveur à serveur

Exécuter Authorize pour Users

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée (`X-Api-Key`)
En-têtes acceptés ou transférés
X-Api-KeyX-Merchant-Id
Essayer
Exemple cURL
POST/users/external-authorize
Users and identityBackend marchand · serveur à serveur

Créer External Authorize

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Backend marchand · serveur à serveur
Autorisation prise en charge
Clé API privée validée ; l’en-tête Bearer utilisateur est transmis lorsqu’il est présent
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Auth-MessageX-Device-IdX-Merchant-Id
Essayer
Exemple cURL
Application client · utilisateur vers serveurÀ utiliser dans les parcours Web ou mobiles avec l’identité et le contexte appareil indiqués.14
GET/users/{user_id}/cards
Cards and vaultApplication client · utilisateur vers serveur

Lister ou récupérer Cards

Domaine
Cards and vault
Service responsable
Payments
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Merchant-ID
Essayer
Exemple cURL
DELETE/users/{user_id}/cards/{card_id}
Cards and vaultApplication client · utilisateur vers serveur

Supprimer Cards

Domaine
Cards and vault
Service responsable
Payments
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
Authorization
Essayer
Exemple cURL
GET/users/{user_id}/cards/{card_id}
Cards and vaultApplication client · utilisateur vers serveur

Récupérer Cards

Domaine
Cards and vault
Service responsable
Payments
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
Authorization
Essayer
Exemple cURL
PATCH/users/{user_id}/cards/{card_id}/set-as-default
Cards and vaultApplication client · utilisateur vers serveur

Définir la carte par défaut

Domaine
Cards and vault
Service responsable
Payments
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Merchant-ID
Essayer
Exemple cURL
POST/v2/users/{user_id}/cards
Cards and vaultApplication client · utilisateur vers serveur

Créer Cards

Domaine
Cards and vault
Service responsable
Payments
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Merchant-ID
Essayer
Exemple cURL
GET/users/{user_id}/addresses
Users and identityApplication client · utilisateur vers serveur

Lister ou récupérer Addresses

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Device-IdX-Merchant-Id
Essayer
Exemple cURL
POST/users/{user_id}/addresses
Users and identityApplication client · utilisateur vers serveur

Créer Addresses

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Device-IdX-Merchant-Id
Essayer
Exemple cURL
DELETE/users/{user_id}/addresses/{address_id}
Users and identityApplication client · utilisateur vers serveur

Supprimer Addresses

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Device-IdX-Merchant-Id
Essayer
Exemple cURL
PATCH/users/{user_id}/addresses/{address_id}
Users and identityApplication client · utilisateur vers serveur

Mettre à jour Addresses

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Device-IdX-Merchant-Id
Essayer
Exemple cURL
POST/users/login
Users and identityApplication client · utilisateur vers serveur

Exécuter Login pour Users

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Flux d’identifiants public avec contexte validé de l’application marchand
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Device-IdX-Merchant-IdX-Qa-Api-KeyX-Recaptcha-TokenX-Session-ID
Essayer
Exemple cURL
POST/users/logout
Users and identityApplication client · utilisateur vers serveur

Exécuter Logout pour Users

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Aucun validateur d’identifiants n’est déclaré dans la Gateway ; l’accès dépend du service responsable ou de la politique réseau
En-têtes acceptés ou transférés
AuthorizationX-Device-IDX-Session-ID
Essayer
Exemple cURL
GET/users/me
Users and identityApplication client · utilisateur vers serveur

Lister ou récupérer Me

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Jeton Bearer de l’utilisateur authentifié
En-têtes acceptés ou transférés
AuthorizationX-Device-IdX-Merchant-Id
Essayer
Exemple cURL
POST/users/register
Users and identityApplication client · utilisateur vers serveur

Exécuter Register pour Users

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Clé API privée ou jeton Bearer, selon le parcours
En-têtes acceptés ou transférés
X-Api-KeyX-Merchant-Id
Essayer
Exemple cURL
POST/users/request-code
Users and identityApplication client · utilisateur vers serveur

Exécuter Request Code pour Users

Domaine
Users and identity
Service responsable
Merchant management
Destiné à
Application client · utilisateur vers serveur
Autorisation prise en charge
Flux d’identifiants public avec contexte validé de l’application marchand
En-têtes acceptés ou transférés
AuthorizationX-Api-KeyX-Device-IdX-Merchant-Id
Essayer
Exemple cURL

Points de terminaison d'intégration principaux#

Les opérations ci-dessous conservent les ancres stables utilisées dans les guides d'intégration et fournissent un contexte supplémentaire pour les flux de travail courants des marchands.

API des commandes#

Créer une commande

POST /merchants/orders

Crée facultativement une commande avant le paiement et renvoie le order_token utilisé par les widgets et les opérations de paiement DEUNA. Les nouvelles intégrations directes peuvent envoyer la commande en ligne à Purchase V2.

L'objet requis varie selon le type de commande : les commandes de paiement et d'abonnement nécessitent le tableau items, tandis que les commandes de compagnies aériennes nécessitent des informations sur la compagnie aérienne. Le contrat de base ne marque pas une propriété individuelle comme étant universellement requise. Voir le référence du champ d'article et guide de champ vertical.

Exemple 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

Obtenir une commande

GET /merchants/orders/{order_token}

Récupère l'état actuel de la commande, du paiement et du traitement pour un jeton de commande.

Exemple 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'

Obtenir les méthodes de paiement pour une commande

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

Renvoie les méthodes de paiement disponibles pour une commande et une configuration de marchand spécifiques.

Exemple 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 de paiement#

Créer un paiement

POST /v2/merchants/orders/purchase

Crée et traite une commande en ligne dans le flux recommandé en un seul appel, ou traite un order_token existant lorsque la commande a été créée séparément. Consultez le guide détaillé de de demande de paiement.

Exemple 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

Effectuer un paiement

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

Effectue l'intégralité ou une partie d'un paiement autorisé. Appelez cette fonction uniquement depuis le backend du commerçant lorsque la connexion prend en charge une autorisation et un paiement séparés.

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

Annuler une autorisation

POST /merchants/orders/{order_token}/void

Annule une autorisation éligible avant le paiement. Une requête synchrone réussie renvoie HTTP 204 No Content; les flux de traitement asynchrones doivent toujours être suivis jusqu'à leur statut de paiement final.

Exemple 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

Effectuer un remboursement

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

Crée un remboursement complet ou partiel pour un paiement effectué.

Exemple 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 pour les utilisateurs#

Ces opérations facultatives prennent en charge l’identité du client, les adresses réutilisables et les instruments de paiement enregistrés de manière sécurisée. Elles ne sont pas obsolètes, mais ne sont pas des prérequis pour Purchase V2. Les applications web et mobiles utilisent l’autorisation client. Les backends marchands de confiance utilisent l’autorisation indiquée pour chaque route dans l’inventaire ci-dessus.

Authentification

Enregistrer un utilisateur

POST /users/register

Crée facultativement un utilisateur qui peut s’authentifier et réutiliser en toute sécurité les données client et les moyens de paiement enregistrés.

Exemple 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

Demander un code OTP

POST /users/request-code

Envoie le code unique utilisé dans le flux d'authentification sans mot de passe.

Exemple 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

Se connecter avec un OTP

POST /users/login

Échange un code unique valide contre un jeton d'autorisation utilisateur.

Exemple 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

Authentification externe

POST /users/external-authorize

Authentifie un utilisateur via un flux d'identité géré par le commerçant.

Exemple 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'

Utilisateurs

GET /users/me

Renvoie le profil de l’utilisateur authentifié lorsque l’intégration utilise des comptes clients facultatifs.

Exemple 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'

Adresses

GET /users/{user_id}/addresses

Répertorie les adresses réutilisables associées à un utilisateur. Cette opération facultative n’est pas requise avant Purchase V2.

Exemple 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

Enregistre facultativement une adresse pour qu’un utilisateur authentifié puisse la réutiliser. Une adresse peut aussi être fournie en ligne dans une requête de paiement.

Exemple 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}

Met à jour une adresse réutilisable existante. L’inventaire indique l’autorisation Bearer et le contexte marchand requis par ces routes facultatives.

Exemple 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

Cartes

Stocke une carte

POST /v2/users/{user_id}/cards

Tokenise et stocke une ou plusieurs cartes pour une utilisation ultérieure. Le corps de la requête est un tableau JSON, même s’il ne contient qu’une seule carte. Appelez cet endpoint autorisé par le client avec le jeton Bearer de l’utilisateur et le contexte marchand affiché dans l’inventaire généré.

Les données brutes de la carte ne doivent pas transiter par les serveurs du marchand, sauf si celui-ci dispose du périmètre PCI requis. Consultez le flux de vaulting de l’API Cards pour connaître la structure de la requête, la limite de sécurité, la réponse de succès et les consignes de nouvelle tentative.

Exemple 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

Quelle route POST de carte dois-je utiliser ?

Seulement POST /v2/users/{user_id}/cards fait partie du contrat actuel de l'API Cards externe. Les autres routes POST qui peuvent apparaître dans les inventaires de Gateway servent à des fins de compatibilité ou de plateforme différentes ; ce ne sont pas trois façons interchangeables de créer une carte.

RouteCe qu'elle fait réellementGuide d'intégration externe
POST /v2/users/{user_id}/cardsTokenise et stocke une ou plusieurs cartes client. Son corps de requête est un tableau, même lorsqu'il contient une seule carte, et la réponse renvoie des card_id values.Utilisez cette route pour les nouvelles intégrations de l'API Cards autorisées par le client.
POST /users/{user_id}/cardsPréserve le contrat de requête de carte unique v1 hérité pour les intégrations existantes.Route de compatibilité ; elle est intentionnellement exclue du catalogue d'API externe actuel. Ne démarrez pas une nouvelle intégration avec elle à moins que DEUNA ne vous le demande explicitement.
POST /users/{user_id}/cards/{card_id}/tokensAjoute un jeton spécifique au processeur ou un résultat de vérification à une carte qui existe déjà. Elle ne crée pas de carte client et ne remplace pas l'opération de /v2 vaulting.Opération gérée par la plateforme ; elle est intentionnellement exclue de la documentation externe et ne doit pas être appelée directement à moins que DEUNA n'approuve le flux et le contrat.

:::info Pourquoi une route peut exister sans apparaître ici L'inventaire de l'API Gateway inclut des routes de compatibilité et des routes opérées par la plateforme, ainsi que des contrats marchands publics. La présence dans la Gateway ne fait pas d'une opération une API externe prise en charge à elle seule. Le catalogue ne publie que les opérations qui font déjà partie de la référence externe ou qui ont l'approbation explicite de l'équipe propriétaire. :::

Lister les cartes enregistrées

GET /users/{user_id}/cards

Renvoie les cartes associées à l’utilisateur authentifié.

Exemple 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'

Récupérer une carte enregistrée

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

Renvoie une carte associée à l’utilisateur authentifié.

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

Définir une carte par défaut

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

Définit ou retire la carte enregistrée sélectionnée comme carte par défaut de l’utilisateur authentifié. Lorsqu’une carte devient la carte par défaut, DEUNA retire ce statut aux autres cartes de l’utilisateur. Consultez Définir une carte par défaut pour connaître le corps de requête facultatif, la réponse et les étapes de vérification.

Exemple 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

Obtenir les informations BIN de la carte

GET /cards/bin/{bin}

Retourne les informations sur le réseau, l'émetteur et le type de carte pour un BIN de six chiffres.

Exemple 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 du commerçant#

API Themes

L'API Themes est prise en charge et n'est pas dépréciée. Elle gère des configurations JSON nommées et délimitées par marchand qui peuvent être appliquées aux expériences DEUNA Checkout et Widget. Appelez ces opérations uniquement depuis un backend marchand de confiance avec la X-Api-Keyprivée ; le service Checkout Configuration déduit la portée marchand de ces informations d'identification.

Ressource Theme

ChampRetournéCréerMise à jourDescriptif
idOuiGénéréParamètre de cheminUUID de thème généré par DEUNA. Utilisez-le comme theme_id pour la mise à jour et la suppression.
nameOuiObligatoireOptionnel lorsque config est fourniNom unique par marchand contenant des lettres, des chiffres ou des tirets bas.
configOuiObligatoireOptionnel lorsque name est fourniObjet JSON contenant la configuration du thème consommée par l'expérience Checkout ou Widget.

L'opération de création rejette les noms en double et applique le nombre maximum de thèmes du service Checkout Configuration. La mise à jour et la suppression renvoient une erreur lorsque theme_id n'appartient pas à un thème existant dans la configuration du marchand.

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"
      }
    }
  }'
ThèmeJSON
{
  "id": "bfcabe59-48c9-4c36-b041-71597478689c",
  "name": "checkout_default",
  "config": {
    "theme": {
      "mainColor": "#1479A8",
      "secondaryColor": "#111827",
      "backgroundColor": "#FFFFFF"
    }
  }
}

L'opération de liste renvoie la même forme de ressource dans data[]. La création et la mise à jour renvoient le thème affecté. La suppression réussit avec une réponse vide.

:::note Schéma de configuration de thème Le service valide que config est un objet JSON mais ne valide pas ses clés imbriquées. Utilisez la forme de configuration prise en charge par la version de Checkout ou de Widget qui consommera le thème. Ne supposez pas qu'un objet config de l'API Themes et un objet CustomStyle du SDK sont interchangeables. :::

Méthodes de paiement

GET /merchants/stores/payments-methods

Récupère les méthodes de paiement activées pour un magasin. Indiquez le code du magasin requis. X-Store-Code header.

Exemple 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

Crée un lien de paiement à partir d'une interface backend de marchand de confiance.

Exemple 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}

Récupère un lien de paiement et son état actuel.

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

GET /merchants/payment-links/all

Répertorie les liens de paiement associés à la boutique du marchand authentifié.

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

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

Répertorie les commandes associées à un lien de paiement.

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

entrée complète de l’endpoint Guide d'intégration des liens de paiement Pour l'ensemble du processus.

API des abonnements#

Plans

GET /subscriptions/plans

Liste des plans d'abonnement disponibles pour le commerçant authentifié.

Exemple 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

Crée un plan d'abonnement.

Exemple 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

Abonnements

Liste des abonnements

GET /subscriptions

Retourne les abonnements disponibles pour le commerçant authentifié.

Exemple 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'

Créer un abonnement

POST /subscriptions

Crée un abonnement à l'aide d'un plan et d'une méthode de paiement existants.

Exemple 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

Mettre à jour un abonnement

PATCH /subscriptions/{id}

Met à jour les attributs pris en charge d'un abonnement actif.

Exemple 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