Démarrage rapide

Créez une clé de test et vérifiez-la. Créez ensuite un dossier et un lien de paiement depuis votre propre code. Comptez environ dix minutes, sans argent réel.

Vérifié sur le code de l'API le 13 octobre 2026

Ezus Pay propose une API REST. Elle permet de créer des dossiers et des liens de paiement, de lire les paiements et d'effectuer des remboursements. Des webhooks signés préviennent votre système dès qu'un événement se produit. Cette page vous guide pas à pas pour un paiement complet en mode test.

Avant de commencer

  • Un compte Ezus Pay avec le rôle admin. Seuls les admins peuvent créer des clés API et des webhooks.
  • Un environnement côté serveur. L'API n'accepte pas les appels d'un navigateur situé sur un autre domaine. Gardez donc votre clé API sur votre serveur.
  • curl ou n'importe quel client HTTP.

Votre premier paiement en cinq étapes

  1. Créer une clé de test

    Dans l'application, passez en Mode test, puis ouvrez Paramètres → Intégrations → Clés API. Créez une clé API avec ces scopes : bookings:write, payment-links:write, payment-links:read et transactions:read.

    La clé ne s'affiche qu'une fois. Elle commence par ezpay_test_. Enregistrez-la dans une variable d'environnement.

    Shell
    export EZP_KEY="ezpay_test_..."

  2. Vérifier la clé

    Shell
    curl https://api.ezuspay.app/v1/ping -H "x-api-key: $EZP_KEY"

    La réponse indique votre agence, les scopes de la clé et "mode": "TEST". Si vous voyez "LIVE", vous utilisez une clé de production.

  3. Créer un dossier

    Un dossier correspond à un voyage. Il peut contenir sa première option chiffrée, appelée alternative.

    Shell
    curl -X POST https://api.ezuspay.app/v1/bookings \
  -H "x-api-key: $EZP_KEY" -H "Content-Type: application/json" \
  -d '{
    "name": "Bali honeymoon 2026",
    "clientName": "Jean Dupont",
    "clientEmail": "jean@example.com",
    "alternative": {
      "alternativeName": "14 jours",
      "totalAmountCents": 480000,
      "departureDate": "2026-07-10",
      "returnDate": "2026-07-24",
      "travelersCount": 2
    }
  }'

    Conservez data.booking.id dans la réponse. Les montants sont toujours des entiers en centimes : 480000 vaut 4 800,00.

  4. Créer un lien de paiement

    Shell
    curl -X POST https://api.ezuspay.app/v1/bookings/BOOKING_ID/payment-links \
  -H "x-api-key: $EZP_KEY" -H "Content-Type: application/json" \
  -d '{ "amountCents": 144000, "label": "Acompte 30 %" }'

    La réponse contient checkoutUrl. C'est la page sur laquelle votre voyageur paie.

  5. Payer et lire le paiement

    Ouvrez checkoutUrl et payez avec la carte de test Stripe 4242 4242 4242 4242. Indiquez n'importe quelle date d'expiration future et n'importe quel CVC. Si un écran de test 3D Secure apparaît, validez-le.

    Listez ensuite les paiements :

    Shell
    curl "https://api.ezuspay.app/v1/transactions?status=SUCCEEDED" -H "x-api-key: $EZP_KEY"

    Pour être prévenu du paiement sans interroger l'API en boucle, ajoutez un webhook. Voir Webhooks.

Passer en production

  1. Repassez l'application en mode production et créez une nouvelle clé API. Les clés de production commencent par ezpay_live_.
  2. Donnez à la clé uniquement les scopes dont elle a besoin. Vous pouvez fixer une date d'expiration de 90, 180 ou 365 jours.
  3. Enregistrez à nouveau vos endpoints de webhook en mode production. Les endpoints de test et de production sont distincts.
  4. Stockez la clé dans un gestionnaire de secrets. Elle ne pourra plus être affichée. En cas de fuite, révoquez-la depuis l'application et créez-en une autre.

Pour aller plus loin

Authentification et erreurs

Clés API, scopes, limites de requêtes, codes d'erreur et conventions.

Référence de l'API

Chaque endpoint, avec ses paramètres et une réponse complète.

Webhooks

Événements, vérification de la signature et nouvelles tentatives.

Checkout intégré

Placez le formulaire de paiement sur votre propre site avec une seule balise script.

Suivant Authentification