Guide

Démarrage rapide

Quatre étapes pour passer votre premier paiement EretuPay.

1. Créer un compte marchand

Inscrivez-vous sur le portail EretuPay.
Activez les comptes réseau nécessaires (TMoney, Flooz…) depuis l’espace client / admin.
Renseignez votre callbackUrl (URL HTTPS qui recevra les notifications).

2. Obtenir vos credentials API

Dans votre profil marchand, générez un couple api_key / api_secret. Conservez le secret hors du code source (variables d’environnement).

3. Obtenir un JWT

POST /api/v2/auth/token

{
  "api_key": "ep_live_xxx",
  "api_secret": "ep_secret_xxx"
}

Réponse :

{
  "code": 2000,
  "token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600
}

4. Lancer un paiement

POST /api/v2/payment/make

Authorization: Bearer <token>
Content-Type: application/json

{
  "network": "tmoney",
  "phone": "90123456",
  "amount": 1000,
  "command_id": "ORDER-1001",
  "description": "Commande #1001"
}

command_id doit être unique par compte réseau : il garantit l’idempotence (un second appel avec le même id renvoie la transaction existante).

Ensuite : suivez le statut via payment/status et recevez le résultat final sur votre callbackUrl.