Documentation API

L'API REST d'EasyPay : authentification, principaux endpoints et webhooks.

Authentification

Les sessions de paiement (checkout) s'authentifient avec votre clé API, dans l'en-tête X-API-Key : ek_live_… pour les vrais paiements, ek_test_… pour le bac à sable, sur la même URL. Les autres endpoints marchands — QR codes, liens de paiement, transactions, webhooks de compte — utilisent la session de votre compte marchand, obtenue avec POST /api/v1/auth/login. La lecture d'une session par son jeton et les endpoints de frais sont publics.

URL de basehttps://easypay.emko.ink

X-API-Key: ek_live_…                    # checkout sessions
Authorization: Bearer <accessToken>     # other merchant endpoints

Principaux endpoints

POST

/api/v1/checkout/sessions

Clé API

Créer une session de paiement

GET

/api/v1/checkout/sessions/{sessionToken}

Public

Lire une session et son statut

GET

/api/v1/checkout/sessions

Clé API

Lister vos sessions

POST

/api/v1/checkout/sessions/{sessionToken}/cancel

Clé API

Annuler une session ouverte

GET

/api/v1/fees/quote

Public

Frais exacts d'un paiement : commission EasyPay et frais du wallet

GET

/api/v1/fees/policies

Public

Politique de frais de chaque moyen de paiement

POST

/api/v1/qr-codes

Session marchande

Créer un QR code, statique ou dynamique

POST

/api/v1/payment-links

Session marchande

Créer un lien de paiement

GET

/api/v1/transactions

Session marchande

Lister les paiements reçus

POST

/api/v1/webhooks

Session marchande

Enregistrer un webhook de compte

Référence complète de l'API

Webhooks

EasyPay notifie votre serveur par des requêtes HTTP POST signées : le callback checkout.paid, envoyé au callbackUrl d'une session de paiement et signé avec votre clé API, et les webhooks de compte (payment.success, payment.failed…), enregistrés via POST /api/v1/webhooks et signés avec leur secret whsec_. L'en-tête X-EasyPay-Signature contient le HMAC-SHA256 hexadécimal du corps brut de la requête. Jusqu'à 6 tentatives pour le callback ; 3 pour les webhooks de compte, relancés 1 minute puis 5 minutes après un échec.

Guide complet des webhooks