Documentation API ElyonPay
Bienvenue dans la documentation technique de l'API ElyonPay. Cette référence vous permet d'intégrer les paiements Mobile Money, Visa, Mastercard et virements dans votre application en quelques lignes de code.
https://api.elyonpay.net/api (Sandbox) / https://api.elyonpay.org/api (Production)Toutes les requêtes doivent être envoyées en HTTPS. Les requêtes HTTP non sécurisées sont refusées. Voir la section Environnements pour plus de détails.
Fonctionnalités clés
- Mobile Money unifié — MTN MoMo, Orange Money, Wave, Moov, Airtel Money
- Cartes bancaires — Visa, Mastercard avec 3D Secure, conformité PCI DSS niveau 1
- Intégration simple — Lien de paiement + iframe, vérification active du statut
- Sandbox complet — Testez sans frais avec des données simulées
- Multi-devises — XAF, XOF, EUR, USD, GBP, NGN, CDF, KES
- SDKs officiels — JavaScript, PHP, Python, Java, React Native, Flutter
Démarrage rapide
Suivez ces 3 étapes pour effectuer votre premier paiement :
- Contactez-nous pour obtenir votre clé API
- Installez le SDK de votre langage ou utilisez cURL directement
- Appelez
POST /api/request-to-pay/payment/linkavec le montant et les URLs de redirection
curl -X POST https://api.elyonpay.org/api/request-to-pay/payment/link \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-H "language: fr" \
-d '{
"amount": 15000,
"user_lang": "fr",
"msisdn": "+237600000000",
"success": "https://yoursite.com/success",
"error": "https://yoursite.com/error"
}'Authentification
L'API ElyonPay utilise l'authentification JWT (JSON Web Token). Obtenez votre token via l'endpoint de login, puis incluez-le dans chaque requête.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| username | string | Requis | Email du compte marchand |
| password | string | Requis | Mot de passe du compte |
| role | string | Requis | ROLE_MERCHANT_ADMIN |
curl -X POST https://api.elyonpay.org/api/login \
-H "Content-Type: application/json" \
-d '{
"username": "you@example.com",
"password": "***",
"role": "ROLE_MERCHANT_ADMIN"
}'Réponse
{
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...."
}Utilisation dans l'en-tête HTTP
Authorization: Bearer <your_jwt_token>Clé API (accès scopé)
En alternative au JWT, une clé API serveur-à-serveur authentifie vos appels de paiement. Elle est disponible pour tous les comptes marchands et se récupère — ou se régénère — depuis votre tableau de bord.
Authorization: Bearer pk_live_...Environnements
ElyonPay propose deux environnements distincts pour vous permettre de développer et tester en toute sécurité avant la mise en production.
URLs de base
| Environnement | URL de base | Description |
|---|---|---|
Sandbox | https://api.elyonpay.net/api | Aucun débit réel — données simulées |
Production | https://api.elyonpay.org/api | Transactions réelles |
Numéros de test Mobile Money
| Numéro | Réseau | Comportement simulé |
|---|---|---|
+237600000001 | MTN MoMo | Paiement réussi |
+237600000002 | MTN MoMo | Solde insuffisant |
+237690000001 | Orange Money | Paiement réussi |
+237690000002 | Orange Money | Timeout simulé |
+221700000001 | Wave | Paiement réussi |
Sandbox & Tests
L'environnement sandbox vous permet de tester l'intégration complète sans effectuer de vrais paiements. Connectez-vous sur api.elyonpay.net — aucun débit réel ne sera effectué.
Comptes de test par pays
Utilisez ces identifiants pour tester l'intégration sur l'environnement sandbox. Chaque compte est associé à un pays et une devise spécifiques.
| Téléphone | Mot de passe | |
|---|---|---|
+237683191284 | demo+23733@elyonpay.com | CompteDemo1 |
| Téléphone | Mot de passe | |
|---|---|---|
+2250758789285 | demo+225@elyonpay.com | CompteDemo1 |
| Téléphone | Mot de passe | |
|---|---|---|
+33895555555 | demo+33@elyonpay.com | CompteDemo1 |
Limites du sandbox
- Les transactions sandbox n'engendrent aucuns frais
- Les données sont réinitialisées tous les 30 jours
- Limite de 1 000 requêtes/heure par clé test
Passer en production
- Complétez la vérification KYB (Know Your Business) dans votre tableau de bord
- Changez l'URL de base de
api.elyonpay.netversapi.elyonpay.org - Vérifiez que vos URLs de redirection (success / error) sont en HTTPS
- Configurez vos alertes de solde bas
Format des requêtes
Toutes les requêtes et réponses utilisent le format JSON. L'en-tête Content-Type: application/json est obligatoire pour les requêtes avec un body.
En-têtes requis
| En-tête | Valeur | Obligatoire |
|---|---|---|
Authorization | Bearer {votre_token_jwt} | Requis |
Content-Type | application/json | Requis (POST) |
Accept | application/json | Optionnel |
Idempotency-Key | UUID unique | Recommandé |
Format de réponse standard
{
"success": true,
"data": {
"id": "pay_1A2B3C4D5E6F",
"status": "pending",
"amount": 15000,
"currency": "XAF"
},
"meta": {
"request_id": "req_xxxxxxx",
"timestamp": "2024-03-24T10:15:00Z"
}
}Créer un paiement
Génère un lien de paiement sécurisé. Le client est redirigé vers ce lien pour choisir sa méthode de paiement (Mobile Money, carte bancaire) et finaliser la transaction.
Paramètres du body
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| amount | number | Requis | Montant du paiement |
| user_lang | string | Requis | Langue de l'interface de paiement (fr, en) |
| msisdn | string | Requis | Numéro de téléphone au format international : +237600000000 |
| success | string | Requis | URL de redirection en cas de succès |
| error | string | Requis | URL de redirection en cas d'erreur |
| webhook | string | Optionnel | URL HTTPS notifiée à chaque changement d'état de la transaction (voir la section Webhooks) |
| external_id | string | Optionnel | Votre référence de commande, 1 à 64 caractères, unique par marchand. Renvoyée dans GET /api/transactions/{uuid} (externalId) et dans les webhooks (data.external_id) |
| customer | object | Optionnel | Votre client final, en un bloc : { account_ref, name, email, phone, locale }. Le même bloc est accepté sur tous les endpoints d'encaissement ; renvoyé dans GET /api/transactions/{uuid} (accountRef, accountName, customerEmail) et dans les webhooks (data.customer) |
| customer.account_ref | string | Optionnel | Identifiant du client chez vous (abonné, compte, n° client…), 1 à 64 caractères : une étiquette que nous vous rendons dans les réponses et les webhooks |
| customer.name | string | Optionnel | Nom déclaré du client, 128 caractères au plus. Affiché dans votre espace marchand ; jamais utilisé comme clé. |
| customer.email | string | Optionnel | E-mail du client, 190 caractères au plus, validé (422 sinon). Conservé sur la transaction pour les messages qui lui sont adressés |
| customer.phone | string | Optionnel | Numéro déclaré du client, au format international. Équivalent de msisdn : l'un des deux suffit. Au paiement, le numéro réellement débité le remplace |
| customer.locale | string | Optionnel | Langue des messages adressés au client (fr, en, en-GB…) |
| onbehalfof | string | number | Optionnel | Encaisser pour le compte d'un sous-marchand : son id ou son code partner. Réservé aux marchands plateforme (voir la section Paiements plateforme) |
| fees | number | Optionnel | Commission plateforme à prélever (même unité que amount). Si absent, les frais par défaut du sous-marchand puis de la plateforme s'appliquent |
player_ref et player_name ne sont plus acceptés. Envoyez customer.account_ref et customer.name. Une requête qui contient encore l'ancien nom est refusée sur tous les endpoints de paiement : 422 PLAYER_REF_REMOVED ou PLAYER_NAME_REMOVED, avec le nom qui le remplace.Réponse
{
"url": "https://app.elyonpay.org/t/CI032667e43abf11?success=https://www.success.com&error=https://www.error.com"
}Exemples de code
cURL
curl -X POST https://api.elyonpay.org/api/request-to-pay/payment/link \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-H "language: fr" \
-d '{
"amount": 15000,
"user_lang": "fr",
"msisdn": "+237600000001",
"success": "https://yoursite.com/success",
"error": "https://yoursite.com/error",
"webhook": "https://yoursite.com/webhooks/elyonpay",
"external_id": "CMD-2026-0042",
"customer": {
"account_ref": "CLT-1001",
"name": "Jean Mballa",
"email": "jean@example.com"
}
}'Node.js / JavaScript
const response = await fetch('https://api.elyonpay.org/api/request-to-pay/payment/link', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + token,
'Content-Type': 'application/json',
'language': 'fr'
},
body: JSON.stringify({
amount: 15000,
user_lang: 'fr',
msisdn: '+237600000001',
success: 'https://yoursite.com/success',
error: 'https://yoursite.com/error',
webhook: 'https://yoursite.com/webhooks/elyonpay',
external_id: 'CMD-2026-0042',
customer: {
account_ref: 'CLT-1001',
name: 'Jean Mballa',
email: 'jean@example.com'
}
})
});
const data = await response.json();
console.log(data.url); // Payment link to redirect the customerPHP
$ch = curl_init('https://api.elyonpay.org/api/request-to-pay/payment/link');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Content-Type: application/json',
'language: fr'
],
CURLOPT_POSTFIELDS => json_encode([
'amount' => 15000,
'user_lang' => 'fr',
'msisdn' => '+237600000001',
'success' => 'https://yoursite.com/success',
'error' => 'https://yoursite.com/error',
'webhook' => 'https://yoursite.com/webhooks/elyonpay',
'external_id' => 'CMD-2026-0042',
'customer' => [
'account_ref' => 'CLT-1001',
'name' => 'Jean Mballa',
'email' => 'jean@example.com'
]
])
]);
$response = json_decode(curl_exec($ch), true);
echo $response['url']; // Payment linkTransactions
Récupérez l'historique complet de vos transactions : paiements reçus, remboursements, frais.
Retourne la liste paginée de toutes vos transactions. Vous pouvez également récupérer le détail d'une transaction spécifique via son identifiant.
Détail d'une transaction
curl -X GET https://api.elyonpay.org/api/transactions/1553 \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Accept: application/json"Exemple de réponse
{
"id": 1553,
"PSPid": "FR033169cbd9c1f1",
"uuid": "FR033169cbd9c1f1",
"creation_date": "2026-03-31T14:27:13+00:00",
"validation_date": null,
"delivery_date": null,
"amount": 100,
"totalCustomer": 100,
"state": "CREATED",
"ticket_type": "SMS_EMAIL",
"operation_code": "03",
"payer_phone_number": "+33782112127",
"beneficiary_phone_number": "+33782112127",
"payer_currency": "EUR",
"beneficiary_currency": "EUR",
"payer_country": "FR",
"beneficiary_country": "FR",
"payment": {
"name": "MOLLIE"
},
"customer": {
"phoneNumber": "+33782112127",
"email": "client@example.com"
},
"merchant": {
"id": 258,
"name": "Ma Boutique",
"city": "Paris",
"address": "10 Rue de la Paix",
"zipCode": "75002",
"type": "individual",
"country_code": "FR",
"country": "France"
},
"transactionStates": [
{
"state": "CREATED",
"date": "2026-03-31T14:27:14+00:00"
}
],
"commission_operateur": 0,
"commission_marchand": 0,
"commission_pays": 0,
"commission_customer": 0,
"deliveryPrice": 0
}Champs de la réponse
| Champ | Type | Description |
|---|---|---|
| id | integer | Identifiant interne de la transaction |
| PSPid | string | Identifiant unique ElyonPay (ex : FR033169cbd9c1f1) |
| uuid | string | Identifiant unique — même valeur que PSPid |
| creation_date | datetime | Date de création (ISO 8601 avec timezone) |
| validation_date | datetime|null | Date de validation du paiement — null si non encore validé |
| delivery_date | datetime|null | Date de livraison — null si non applicable |
| amount | number | Montant de la transaction dans la devise du bénéficiaire |
| totalCustomer | number | Montant total facturé au client (commissions incluses) |
| state | string | Statut actuel : CREATED, PENDING, WAITING_FOR_PAYMENT, ACCEPTED, DELIVERED, REJECTED, DECLINED, CANCELLED |
| ticket_type | string | Type de notification : SMS_EMAIL, SMS, EMAIL |
| operation_code | string | Code d'opération interne |
| payer_phone_number | string | Numéro de téléphone du payeur (format international) |
| externalId | string|null | Votre référence de commande (external_id), telle que fournie à la création |
| accountRef | string|null | Identifiant de votre client final (customer.account_ref), tel que fourni à la création |
| accountName | string|null | Nom déclaré du client final (customer.name) |
| customerEmail | string|null | E-mail déclaré du client final (customer.email) |
| beneficiary_phone_number | string | Numéro de téléphone du bénéficiaire |
| payer_currency | string | Devise du payeur (code ISO 4217 : EUR, XAF, XOF...) |
| beneficiary_currency | string | Devise du bénéficiaire |
| payer_country | string | Code pays du payeur (ISO 3166 : FR, CM, CI...) |
| beneficiary_country | string | Code pays du bénéficiaire |
| payment.name | string | Fournisseur de paiement utilisé (MOLLIE, MTN, ORANGE...) |
Objet customer
| Champ | Type | Description |
|---|---|---|
| phoneNumber | string | Numéro de téléphone du client |
| string | Adresse email du client |
Objet merchant
| Champ | Type | Description |
|---|---|---|
| id | integer | Identifiant du marchand |
| name | string | Nom du marchand ou de l'enseigne |
| city | string | Ville du marchand |
| address | string | Adresse postale |
| zipCode | string | Code postal |
| type | string | Type de compte : individual, company |
| country_code | string | Code pays ISO 3166 (FR, CM, CI...) |
| country | string | Nom du pays |
Tableau transactionStates
Historique des changements de statut de la transaction, du plus ancien au plus récent.
| Champ | Type | Description |
|---|---|---|
| state | string | Statut à cet instant (CREATED, PENDING, WAITING_FOR_PAYMENT, ACCEPTED, DELIVERED...) |
| date | datetime | Date du changement de statut |
Commissions
| Champ | Type | Description |
|---|---|---|
| commission_operateur | number | Commission opérateur télécom |
| commission_marchand | number | Commission marchand |
| commission_pays | number | Commission pays |
| commission_customer | number | Commission appliquée au client |
| deliveryPrice | number | Frais de livraison |
Custom Checkout
Le Custom Checkout vous permet de construire votre propre interface de paiement tout en utilisant les APIs ElyonPay. Contrairement au lien de paiement simple (redirect), vous gardez le contrôle complet de l'expérience utilisateur.
Flux en 4 étapes
Récupérer les méthodes de paiement
Appelez GET /api/public/configuration/payments/{countryCode} pour obtenir la liste des méthodes disponibles dans le pays du client.
Afficher votre checkout
Présentez le récapitulatif et les méthodes de paiement dans votre propre interface. Le client choisit comment payer.
Initier le paiement
Envoyez la requête de paiement direct (Mobile Money ou carte bancaire) avec la méthode choisie.
Suivre le statut
Interrogez GET /api/transactions/{id} toutes les 3 à 5 secondes jusqu'à obtenir un statut terminal (DELIVERED, FAILED, CANCELLED).
Diagramme de séquence
sequenceDiagram
participant Customer
participant Merchant
participant ElyonPay
Customer->>Merchant: Browses products
Merchant->>ElyonPay: GET /api/public/configuration/payments/{country}
ElyonPay-->>Merchant: Available payment methods
Customer->>Merchant: Selects payment method
Merchant->>ElyonPay: POST /api/mobile-money/payment/request
ElyonPay-->>Merchant: PaymentResult (transactionId, state)
loop Poll every 3-5s (max 2 min)
Merchant->>ElyonPay: GET /api/transactions/{id}
ElyonPay-->>Merchant: Transaction state
end
Merchant->>Customer: Displays confirmation or error
Méthodes de paiement
Récupérez dynamiquement la liste des méthodes de paiement disponibles dans un pays donné. Cet endpoint est public — aucune authentification n'est requise.
Paramètre de chemin
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| countryCode | string | Requis | Code pays ISO 3166 — voir le tableau ci-dessous |
Codes pays supportés
| Code | Pays |
|---|---|
CM | Cameroun |
CI | Côte d'Ivoire |
GA | Gabon |
FR | France |
TG | Togo |
BJ | Bénin |
Exemple de réponse
{
"payments": [
{
"name": "ORANGE_MONEY",
"label": "Orange Money",
"type": "MOBILE_MONEY",
"available": true
},
{
"name": "MTN_MONEY",
"label": "MTN Mobile Money",
"type": "MOBILE_MONEY",
"available": true
},
{
"name": "STRIPE",
"label": "Carte bancaire (Visa / Mastercard)",
"type": "CARD",
"available": true
}
]
}curl https://api.elyonpay.org/api/public/configuration/payments/CMPaiement direct
Initiez un paiement directement depuis votre serveur sans redirection vers une page ElyonPay. Le client reste sur votre site pendant toute la transaction.
Mobile Money
Paramètres du body
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| amount | number | Requis | Montant du paiement dans la devise locale |
| user_lang | string | Requis | Langue de l'utilisateur (fr, en) |
| merchant_name | string | Requis | Nom du marchand affiché au client |
| merchant_id | integer | Requis | Identifiant du marchand |
| currency | string | Requis | Code devise ISO 4217 (XAF, XOF, EUR...) |
| country_name | string | Requis | Nom du pays du client |
| payment_method | string | Requis | Doit correspondre au champ name retourné par GET /api/public/configuration/payments/{countryCode} |
| msisdn | string | Requis | Numéro de téléphone du client (format international) |
| transaction | string | Optionnel | Référence de transaction externe (optionnel) |
cURL
curl -X POST https://api.elyonpay.org/api/mobile-money/payment/request \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"amount": 15000,
"user_lang": "fr",
"merchant_name": "Ma Boutique",
"merchant_id": 207,
"currency": "XAF",
"country_name": "Cameroon",
"payment_method": "ORANGE_MONEY",
"msisdn": "+237690000001"
}'Node.js / JavaScript
const response = await fetch('https://api.elyonpay.org/api/mobile-money/payment/request', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + token,
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 15000,
user_lang: 'fr',
merchant_name: 'Ma Boutique',
merchant_id: 207,
currency: 'XAF',
country_name: 'Cameroon',
payment_method: 'ORANGE_MONEY',
customer_msisdn: '+237690000001'
})
});
const result = await response.json();
// Start polling result.data.uuid for statusPHP
$ch = curl_init('https://api.elyonpay.org/api/mobile-money/payment/request');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => json_encode([
'amount' => 15000,
'user_lang' => 'fr',
'merchant_name' => 'Ma Boutique',
'merchant_id' => 207,
'currency' => 'XAF',
'country_name' => 'Cameroon',
'payment_method' => 'ORANGE_MONEY',
'customer_msisdn' => '+237690000001'
])
]);
$response = json_decode(curl_exec($ch), true);
// Start polling $response['data']['uuid'] for statusCarte bancaire
Même payload que le paiement Mobile Money, à une exception près : payment_method ne désigne pas un opérateur mais le prestataire qui traite la carte. S'y ajoutent deux paramètres pour contrôler la redirection après paiement.
Paramètres supplémentaires
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| payment_method | string | Requis | MOLLIE ou STRIPE — le prestataire qui traite la carte. Ce sont les deux seules valeurs acceptées : toute autre valeur est refusée en 422. |
| success | string | Optionnel | URL de redirection après un paiement réussi. Le client sera redirigé vers {success}?id={uuid}&status=pending |
| error | string | Optionnel | URL de redirection après un paiement échoué ou annulé. Le client sera redirigé vers {error}?id={uuid}&status=cancelled |
Si ces paramètres ne sont pas fournis, le client sera redirigé vers la page de transaction ElyonPay par défaut.
Important : ne vous fiez jamais uniquement à l'URL de redirection (success/error) pour confirmer un paiement. Un utilisateur peut modifier l'URL manuellement. Vérifiez toujours le statut côté serveur via GET /api/transactions/{uuid}.
Réponse — PaymentResult
{
"success": true,
"data": {
"PSPid": "tr_aHYQAw4rudrttLDwtdKTJ",
"PSPnotifyId": "tr_aHYQAw4rudrttLDwtdKTJ",
"PSPtxnId": "tr_aHYQAw4rudrttLDwtdKTJ",
"url": "https://www.mollie.com/checkout/credit-card/session/aHYQAw4rudrttLDwtdKTJ",
"uuid": "CM06306a438d0958",
"PSPMessage": null,
"PSPstatus": ""
}
}Champs de la réponse
| Champ | Type | Description |
|---|---|---|
| success | boolean | Indique si la requête a réussi |
| data.PSPid | string | Identifiant du prestataire de paiement (PSP) |
| data.PSPnotifyId | string | Identifiant de notification PSP |
| data.PSPtxnId | string | Identifiant de transaction PSP |
| data.url | string | URL de paiement (redirection carte bancaire si applicable) |
| data.uuid | string | Identifiant unique ElyonPay — utilisez-le pour le polling |
| data.PSPMessage | string|null | Message retourné par le PSP (null si aucun) |
| data.PSPstatus | string | Statut retourné par le PSP |
Suivi du statut
Après avoir initié un paiement direct, interrogez périodiquement l'API pour connaître le résultat de la transaction. Le polling est le mécanisme de référence ; des webhooks optionnels sont également disponibles pour être notifié en temps réel.
États terminaux
| État | Résultat | Description |
|---|---|---|
| DELIVERED | Succès | Paiement confirmé, fonds transférés |
| FAILED | Échec | Paiement échoué (solde insuffisant, erreur réseau...) |
| DECLINED | Échec | Paiement refusé par l'opérateur |
| CANCELLED | Échec | Annulé par le client ou le système |
| PENDING | Payé | Paiement confirmé. Malgré son nom, cet état signifie que l'argent est encaissé : vous pouvez honorer la commande. Il n'attend plus que la livraison, pas le paiement. |
Le mot « pending » prête à confusion : chez la plupart des prestataires de paiement il signifie « en cours, rien n'est décidé », alors qu'ici il signifie l'inverse — le paiement est encaissé. Nous le renommons donc en WAITING_FOR_DELIVERY, qui dit ce qu'il attend réellement.
Aujourd'hui : rien ne change. L'API et les webhooks continuent d'envoyer state = "PENDING" et l'événement transaction.pending. Vos intégrations existantes fonctionnent sans modification.
Pour vous préparer : acceptez dès maintenant les deux valeurs, PENDING et WAITING_FOR_DELIVERY, ainsi que les deux noms d'événement. Traitez-les comme un paiement confirmé et non comme une transaction en cours. La bascule sera annoncée à l'avance et ne se fera pas avant que vous ayez eu le temps de migrer.
Exemple complet — Node.js / Express
Cet exemple couvre les 4 étapes du Custom Checkout : méthodes de paiement, affichage, paiement direct et polling du statut.
const express = require('express');
const app = express();
app.use(express.json());
const API = 'https://api.elyonpay.org/api';
let token = ''; // Obtained via POST /api/login
// Helper: poll transaction status
async function pollStatus(txId, maxMs = 120000, intervalMs = 4000) {
const start = Date.now();
while (Date.now() - start < maxMs) {
const res = await fetch(`${API}/transactions/${txId}`, {
headers: { 'Authorization': 'Bearer ' + token }
});
const tx = await res.json();
const terminal = ['DELIVERED', 'FAILED', 'DECLINED', 'CANCELLED'];
if (terminal.includes(tx.state)) return tx;
await new Promise(r => setTimeout(r, intervalMs));
}
throw new Error('Polling timeout');
}
// Step 1 — Get payment methods for customer's country
app.get('/payment-methods/:country', async (req, res) => {
const methods = await fetch(
`${API}/public/configuration/payments/${req.params.country}`
).then(r => r.json());
res.json(methods);
});
// Steps 2-3-4 — Customer picks method, initiate payment, poll result
app.post('/pay', async (req, res) => {
const { payment_method, phone, merchant_id, amount } = req.body;
// Step 3 — Initiate direct payment
const payment = await fetch(`${API}/mobile-money/payment/request`, {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + token,
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount,
user_lang: 'fr',
merchant_name: 'Ma Boutique',
merchant_id,
currency: 'XAF',
country_name: 'Cameroon',
payment_method,
customer_msisdn: phone
})
}).then(r => r.json());
// Step 4 — Poll for terminal state
try {
const tx = await pollStatus(payment.data.uuid);
if (tx.state === 'DELIVERED') {
res.json({ success: true, transaction: tx });
} else {
res.json({ success: false, state: tx.state, transaction: tx });
}
} catch (err) {
res.status(408).json({ success: false, error: 'Payment timeout' });
}
});
app.listen(3000);Preuve de livraison
Des champs supplémentaires, ajoutés à vos appels de paiement existants, pour constituer automatiquement un dossier lorsqu'un porteur de carte conteste avoir reçu un bien ou service numérique. Aucun nouvel endpoint à intégrer : les champs viennent s'ajouter au paiement que vous envoyez déjà.
Où ces champs s'appliqueront
Sur les paiements par carte, où une contestation est possible. Les paiements Mobile Money et Cash restent inchangés : irrévocables, ils ne peuvent pas faire l'objet d'un litige.
| Endpoint | Rail | Statut prévu |
|---|---|---|
| /stripe/payment/request | Carte | Requis |
| /bankcard/payment/request | Carte | Requis |
| /request-to-pay/payment/request | Carte possible | Requis |
| /request-to-pay/payment/initialize | Carte possible | Requis |
| /request-to-pay/payment/link | Carte, payée plus tard | Requis |
| /mobile-money/payment/request, /cash/payment/request | Irrévocable | Accepté, jamais requis |
Champs
Tous s'ajoutent au premier niveau du corps de la requête, à côté de amount, merchant_id, etc. — pas de bloc imbriqué.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| external_id | string | Requis | Votre référence de commande. C'est ce qui vous permet de rapprocher nos transactions des vôtres — nous ne pouvons pas l'inventer à votre place. |
| product_type | string (enum) | Requis | Ce que vous livrez : DIGITAL_DOWNLOAD, DIGITAL_ACCESS, SERVICE ou PHYSICAL. Détermine automatiquement le mode de confirmation (voir ci-dessous) — vous ne le choisissez pas séparément. |
| service_description | string | Requis | Une phrase décrivant ce qui est vendu. C'est ce que lira l'analyste du réseau de carte en cas de litige. |
| terms.accepted_at | string (ISO 8601) | Requis | Horodatage d'acceptation de vos CGV par le client. |
| terms.version | string | Requis | La version des CGV acceptée. |
| customer.email | string | Conditionnel | E-mail du payeur. Au moins l'un des deux — email ou phone — sera exigé ; les deux peuvent être fournis. |
| customer.phone | string | Conditionnel | Téléphone du payeur. Sur /stripe/payment/request et /bankcard/payment/request, peut aussi être fourni via le champ existant customer_msisdn, qui restera pris en charge — vous n'êtes pas obligé de migrer avant la date d'activation. |
| customer.account_ref | string | Optionnel | Identifiant du client chez vous, 1 à 64 caractères. C'est le même bloc customer que sur le lien de paiement : il est déjà accepté aujourd'hui, avec customer.name, customer.email et customer.locale. |
| customer.name | string | Optionnel | Nom déclaré du client, 128 caractères au plus. |
Sur /request-to-pay/payment/request, /initialize et /link, le téléphone du payeur est déjà connu (le msisdn transmis) : rien à ajouter pour satisfaire la condition email/phone, sauf si vous voulez aussi fournir l'e-mail.
Valeurs de product_type
| Valeur | Exemple | Mode de confirmation |
|---|---|---|
| DIGITAL_DOWNLOAD | Film, PDF, formation à télécharger | Lien signé — le clic vaut confirmation |
| DIGITAL_ACCESS | Abonnement, accès ouvert dans un système tiers | Validation par votre système |
| SERVICE | Prestation de service | QR code présenté à la remise |
| PHYSICAL | Bien physique remis en main propre | QR code présenté à la remise |
Aperçu du payload
Sur /bankcard/payment/request, à titre d'illustration — les cinq derniers champs n'ont aujourd'hui aucun effet (voir l'encart ci-dessus).
{
"amount": 15000,
"merchant_id": 4821,
"operation_code": "33",
"currency": "XAF",
"payment_method": "MOLLIE",
"user_lang": "fr",
"customer_msisdn": "+24106000000",
"external_id": "CMD-88213",
"product_type": "DIGITAL_DOWNLOAD",
"service_description": "Formation Trésorerie PME, 4 modules vidéo",
"customer": { "email": "jean@example.com", "phone": "+24106000000" },
"terms": { "accepted_at": "2026-09-06T10:00:00Z", "version": "cgv-2026-03" }
}SDKs & plugins officiels
Des SDKs et plugins officiels sont disponibles pour intégrer ElyonPay dans vos projets. Ils gèrent automatiquement l'authentification, les appels API et la vérification du statut des paiements.
SDK PHP officiel pour intégrer l'API ElyonPay. Zéro dépendance externe — utilise uniquement cURL natif.
Plugin WooCommerce officiel. Acceptez Mobile Money et cartes bancaires directement depuis votre boutique WordPress.
SDK officiel pour intégrer le Custom Checkout dans vos applications React et Vue.js. Hooks, composables et polling automatique inclus.
Flux d'intégration
ElyonPay utilise un modèle en 6 étapes basé sur un lien de paiement et une vérification active du statut (modèle pull). Aucune infrastructure webhook n'est requise — des webhooks optionnels sont toutefois disponibles en complément.
Obtenir un lien de paiement
Votre backend appelle POST /api/request-to-pay/payment/link avec le montant et les URLs de redirection (success / error). L'API retourne une URL de paiement unique.
Afficher l'iframe de paiement
Redirigez le client vers l'URL retournée, ou intégrez-la dans une iframe. Le client choisit sa méthode de paiement (Mobile Money, carte bancaire) et saisit ses informations.
Validation du paiement
Le client confirme le paiement côté opérateur (code USSD Mobile Money, 3D Secure carte). ElyonPay traite la transaction.
Redirection vers votre backend
Une fois le paiement traité, le client est redirigé vers votre URL success ou error selon le résultat. L'UUID de la transaction est transmis dans l'URL de redirection.
Vérifier le statut de la transaction
Votre backend appelle GET /api/transactions/{uuid} pour récupérer le statut définitif de la transaction. Cette vérification côté serveur est indispensable — ne vous fiez jamais uniquement à l'URL de redirection.
Afficher la confirmation au client
Selon le statut retourné (DELIVERED, REJECTED, CANCELLED...), affichez la page de confirmation ou d'erreur appropriée à votre client.
Diagramme — Initiation du paiement
sequenceDiagram
participant Customer
participant Merchant
participant ElyonPay
Customer->>Merchant: Finalizes cart
Customer->>Merchant: Selects "Pay"
Merchant->>ElyonPay: POST /api/login
ElyonPay-->>Merchant: Returns JWT token
Merchant->>ElyonPay: POST /api/request-to-pay/payment/link
ElyonPay-->>Merchant: Returns payment URL
Merchant->>Customer: Displays payment page (iframe or redirect)
Customer->>ElyonPay: Selects payment method
Customer->>ElyonPay: Completes transaction
ElyonPay-->>Customer: Shows confirmation popup
Diagramme — Résultat du paiement
sequenceDiagram
participant Customer
participant Merchant
participant ElyonPay
Customer->>ElyonPay: Transaction completed
alt Successful payment
ElyonPay->>Merchant: Redirect to success URL
else Failed payment
ElyonPay->>Merchant: Redirect to error URL
end
Merchant->>ElyonPay: GET /api/transactions/[ID_TRANSACTION]
ElyonPay-->>Merchant: Returns transaction status
Merchant->>Merchant: Updates order status
Merchant->>Customer: Shows order confirmation
Exemple d'implémentation (étapes 1 → 5)
Node.js / Express
// 1. Create payment link
app.post('/checkout', async (req, res) => {
const response = await fetch('https://api.elyonpay.org/api/request-to-pay/payment/link', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + token,
'Content-Type': 'application/json',
'language': 'fr'
},
body: JSON.stringify({
amount: req.body.amount,
user_lang: 'fr',
msisdn: req.body.phone,
success: 'https://yoursite.com/payment/done',
error: 'https://yoursite.com/payment/error'
})
});
const { url } = await response.json();
res.redirect(url); // 2. Redirect customer to payment page
});
// 4 → 5. Handle redirect & verify status
app.get('/payment/done', async (req, res) => {
// The transaction uuid is available from your order context
const tx = await fetch(`https://api.elyonpay.org/api/transactions/${uuid}`, {
headers: { 'Authorization': 'Bearer ' + token }
}).then(r => r.json());
if (tx.state === 'DELIVERED') {
// 6. Show confirmation
res.render('success', { transaction: tx });
} else {
res.render('pending', { transaction: tx });
}
});Mobile Money
ElyonPay unifie 5 réseaux Mobile Money africains sous une seule API. Chaque réseau possède ses propres codes opérateurs et pays de couverture.
Réseaux supportés
| Code méthode | Réseau | Pays | Devises |
|---|---|---|---|
mtn_mobile_money | MTN MoMo | CM, NG, CI, GH, UG | XAF, NGN, XOF |
orange_money | Orange Money | CM, CI, SN, ML | XAF, XOF |
wave | Wave | SN, CI, BF, ML | XOF |
moov_money | Moov Africa | BJ, TG, BF, NE | XOF |
airtel_money | Airtel Money | KE, TZ, UG, ZM, CD | KES, TZS, UGX, CDF |
Couverture : Cameroun, Nigeria, Côte d'Ivoire, Ghana, Ouganda, Sénégal, Mali, Burkina Faso, Bénin, Togo, Niger, Kenya, Tanzanie, Zambie, République Démocratique du Congo.
Cartes bancaires
Acceptez les paiements Visa et Mastercard avec 3D Secure, tokenisation et conformité PCI DSS niveau 1.
Cartes de test (Sandbox)
| Numéro de carte | Expiration | CVV | Comportement |
|---|---|---|---|
4242 4242 4242 4242 | 12/28 | 123 | Paiement réussi |
4000 0000 0000 0002 | 12/28 | 123 | Carte refusée |
4000 0000 0000 3220 | 12/28 | 123 | 3D Secure requis |
5555 5555 5555 4444 | 12/28 | 123 | Mastercard réussi |
Paiements plateforme (Split)
Une plateforme (marketplace) peut encaisser un paiement pour le compte de ses marchands. ElyonPay répartit automatiquement les fonds entre le sous-marchand et la plateforme : le sous-marchand reçoit le montant net et la plateforme prélève sa commission, en une seule transaction côté client. La répartition peut aussi viser plusieurs bénéficiaires à la fois, avec le paramètre splits.
Étape 1 — Créer vos sous-marchands
Avant d'encaisser pour le compte d'un marchand, vous devez le déclarer comme sous-marchand de votre plateforme. Deux méthodes sont disponibles :
- Depuis le dashboard — dans la section Sous-marchands de votre tableau de bord plateforme, ajoutez un marchand via le formulaire (identité, pays, frais par défaut). Idéal pour une gestion manuelle.
- Via l'API — créez vos sous-marchands par programmation avec l'endpoint dédié ci-dessous. Idéal pour un onboarding automatisé.
Paramètres du body
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| name | string | Requis | Nom commercial du sous-marchand |
| country_code | string | Requis | Code pays ISO 3166 (ex. CM) |
| city | string | Requis | Ville |
| address | string | Requis | Adresse |
| type | string | Requis | Type d'activité (ex. RETAIL) |
| owner_email | string | Requis | E-mail du propriétaire du compte |
| owner_phone_number | string | Requis | Téléphone du propriétaire |
| owner_first_name | string | Requis | Prénom du propriétaire |
| owner_last_name | string | Requis | Nom du propriétaire |
| owner_password | string | Requis | Mot de passe initial du compte propriétaire |
| default_marketplace_fee_percent | number | Optionnel | Commission par défaut (%) prélevée sur les paiements de ce sous-marchand. Sinon, les frais par défaut de la plateforme s'appliquent |
curl -X POST https://api.elyonpay.org/api/merchant/sub-merchants \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Boutique ABC",
"country_code": "CM",
"city": "Douala",
"address": "123 Rue Commerce",
"type": "RETAIL",
"owner_email": "owner@boutique-abc.com",
"owner_phone_number": "+237600000000",
"owner_first_name": "Jean",
"owner_last_name": "Dupont",
"owner_password": "s3cur3-p4ssword",
"default_marketplace_fee_percent": 5.00
}'{
"merchant_id": 725,
"uuid": "a1b2c3d4-...",
"name": "Boutique ABC",
"owner_email": "owner@boutique-abc.com",
"owner_phone": "+237600000000",
"kyb_required": true,
"default_fee_percent": "5.00"
}Notez le merchant_id retourné : c'est l'identifiant que vous passerez dans onbehalfof pour encaisser pour ce marchand. Le sous-marchand doit avoir un compte de payout configuré (pour recevoir les fonds) ; sa vérification KYB peut par ailleurs être requise avant la mise en production.
Gérer vos sous-marchands
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/merchant/sub-merchants | Lister vos sous-marchands |
| GET | /api/merchant/sub-merchants/{id} | Détail d'un sous-marchand |
| PATCH | /api/merchant/sub-merchants/{id}/fees | Modifier sa commission par défaut |
Étape 2 — Encaisser pour un sous-marchand
Créez le paiement normalement (voir Créer un paiement), en ajoutant le paramètre onbehalfof contenant l'id ou le code partner du sous-marchand. ElyonPay crée alors un paiement réparti.
curl -X POST https://api.elyonpay.org/api/request-to-pay/payment/link \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-H "language: fr" \
-d '{
"amount": 15000,
"user_lang": "fr",
"msisdn": "+237600000001",
"success": "https://yoursite.com/success",
"error": "https://yoursite.com/error",
"webhook": "https://yoursite.com/webhooks/elyonpay",
"onbehalfof": 725
}'Comment la commission est calculée
La commission prélevée par la plateforme est résolue dans cet ordre de priorité :
- Le paramètre
feesfourni dans l'appel (montant exact, prioritaire s'il est présent). - Sinon, la commission par défaut du sous-marchand (default_marketplace_fee_percent).
- Sinon, la commission par défaut configurée sur la plateforme.
- Si aucune source n'est disponible, la requête est rejetée (erreur 400).
La commission doit être positive et strictement inférieure au montant, et respecter les plafonds définis sur la plateforme. Le sous-marchand reçoit amount − commission, la plateforme reçoit la commission.
Sous-marchand encaissant directement
Un sous-marchand peut aussi initier lui-même un paiement, avec sa propre clé API, sans passer par la plateforme. Dans ce cas, n'ajoutez pas onbehalfof : le split vers la plateforme parente s'applique automatiquement, avec les mêmes règles de commission.
Répartir entre plusieurs bénéficiaires
onbehalfof désigne un seul sous-marchand. Pour répartir un même encaissement entre plusieurs bénéficiaires, envoyez splits : un tableau d'entrées { merchant, percent }, où merchant est l'id ou le code partner du bénéficiaire. Disponible sur les liens de paiement (request-to-pay) et sur les paiements par carte. Les paiements en espèces ne sont pas répartis.
curl -X POST https://api.elyonpay.org/api/request-to-pay/payment/link \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-H "language: fr" \
-d '{
"amount": 15000,
"user_lang": "fr",
"msisdn": "+237600000001",
"success": "https://yoursite.com/success",
"error": "https://yoursite.com/error",
"splits": [
{ "merchant": 725, "percent": 60 },
{ "merchant": "PART-EGT-00042", "percent": 25 }
]
}'Le payeur paie 15 000 XAF : le premier bénéficiaire reçoit 9 000, le second 3 750, et la plateforme garde le reste, soit 2 250. Ce reste est une soustraction et non un pourcentage, ce qui rend la répartition exacte à l'unité sans règle d'arrondi : si trois parts de 33,33 % laissent une unité orpheline, elle reste à la plateforme.
La plateforme doit toujours garder une part strictement positive. Ce n'est pas une règle commerciale : c'est sa part qui porte le coût réel de l'encaissement. Sans elle, ce coût tomberait sur un bénéficiaire qui n'a pas choisi le moyen de paiement.
Ce que amount veut dire : split_mode
Une seule question détermine tout le calcul : amount est-il ce que le payeur paie, ou ce que les destinataires reçoivent ?
| split_mode | amount | Quand l'utiliser |
|---|---|---|
| SUBTRACTIVEdéfaut | Ce que le payeur paie. Les parts sont prélevées dedans et leur somme égale le montant. | Le cas courant : vous annoncez un prix à votre client, vous l'encaissez, vous le répartissez. |
| ADDITIVE | Ce que le destinataire principal reçoit. Les parts s'ajoutent par-dessus et le payeur paie davantage. | Une somme due à un tiers qui n'a pas à supporter vos frais : une taxe, un reversement réglementaire. Le destinataire touche son montant nominal au franc près, quel que soit le barème appliqué autour. |
En mode ADDITIVE, deux champs supplémentaires sont nécessaires. principal nomme qui reçoit le montant lui-même — onbehalfof fait aussi l'affaire, puisqu'il dit déjà pour le compte de qui vous encaissez. Et votre plateforme doit figurer dans splits avec sa propre part : c'est elle qui absorbe l'écart entre le coût de rail estimé et le coût réel, connu seulement au règlement.
curl -X POST https://api.elyonpay.org/api/request-to-pay/payment/link \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-H "language: fr" \
-d '{
"amount": 25000,
"split_mode": "ADDITIVE",
"principal": 931,
"user_lang": "fr",
"msisdn": "+237600000001",
"success": "https://yoursite.com/success",
"error": "https://yoursite.com/error",
"splits": [
{ "merchant": 725, "percent": 8 }
]
}'Le bénéficiaire 931 reçoit exactement 25 000 XAF. La plateforme 725 prend 8 % de ce montant, soit 2 000 XAF, en surcharge. Le payeur règle 27 000 XAF, plus les commissions ElyonPay, qui lui sont également imputées. En mode additif, aucun bénéficiaire autre que votre plateforme ne supporte nos frais : chacun touche sa part nominale.
Règles de la répartition
- Le compte appelant doit être une plateforme, et chaque bénéficiaire doit lui appartenir.
- Chaque bénéficiaire doit avoir un compte de versement configuré, sans quoi sa part resterait impayable.
- Un même bénéficiaire ne peut apparaître qu'une fois : additionnez ses pourcentages vous-même.
- Chaque percent doit être strictement supérieur à 0, et la part qui en résulte doit valoir au moins une unité monétaire après arrondi.
- En SUBTRACTIVE, la plateforme ne figure pas dans splits : elle reçoit le reste. En ADDITIVE, elle doit au contraire y figurer.
- Si un plafond de commission est configuré sur votre plateforme, il s'applique à sa part, exactement comme aux frais de onbehalfof.
Codes d'erreur
| Situation | Code |
|---|---|
| Le compte appelant n'est pas une plateforme, ou le sous-marchand appartient à une autre plateforme | 403 |
| Sous-marchand introuvable (id ou code partner) | 404 |
| Commission invalide (négative, ≥ montant, plafond dépassé) ou aucun compte de payout configuré | 400 |
| splits vide, percent ≤ 0, ou part arrondissant à zéro | 400 |
| Un même bénéficiaire apparaît deux fois dans splits | 400 |
| La somme des parts ne laisse rien à la plateforme, qui porte le coût de l'encaissement | 400 |
| Mode ADDITIVE sans principal, ou sans part pour la plateforme elle-même | 400 |
| Un bénéficiaire de splits n'appartient pas à la plateforme appelante | 403 |
Versements
Une fois un paiement livré, ElyonPay vous reverse votre part. Le moment où cet argent quitte nos comptes dépend du mode de versement réglé sur le vôtre.
Les quatre modes de versement
| Mode | Quand les fonds partent | Ce que cela implique |
|---|---|---|
| INSTANTdéfaut | Dès que possible après la livraison du paiement. | Vous êtes payé au plus vite, au palier tarifaire instantané, qui est le plus cher. |
| DELAYED | À la date de règlement de l'établissement de paiement, automatiquement. | L'attente a une fin connue d'avance et personne n'a rien à faire pour qu'elle arrive. Palier tarifaire standard. |
| MANUAL | Quand un opérateur ElyonPay libère le versement. | Réservé aux comptes dont les versements font l'objet d'un contrôle avant départ. Palier tarifaire standard. |
| WALLET | Jamais par vente. Le montant net est crédité à votre solde chez nous, et n'en sort que par vos demandes de décaissement. | Pour les comptes dont les encaissements sont l'argent de leurs clients, reversé plus tard. Palier tarifaire standard. |
Un encaissement par virement bancaire prend toujours le palier standard, même sur un compte en mode INSTANT : un virement ne se règle pas instantanément, quel que soit le mode.
Compte en mode wallet : consulter son solde
Un compte en mode wallet dispose d'un endpoint dédié, appelable avec sa clé d'API comme ses encaissements.
curl -X GET https://api.elyonpay.org/api/wallet/balance \
-H "Authorization: Bearer <your_jwt_token>"{
"currency": "XAF",
"balance": 1250000,
"pending_release": 300000,
"available": 950000,
"release_delay_hours": 72,
"as_of": "2026-10-20T17:12:04+00:00"
}| Champ | Signification |
|---|---|
| currency | La devise du solde, celle du pays de votre compte. |
| balance | Tout ce que nous détenons pour vous, disponible ou non. |
| pending_release | La part de ce solde issue de dépôts trop récents pour être décaissés. |
| available | Ce que vous pouvez décaisser maintenant : balance − pending_release. |
| release_delay_hours | Le délai de disponibilité appliqué à votre compte, en heures. |
| as_of | L'instant du calcul, au format ISO 8601. |
Le délai de disponibilité vaut 72 heures en production. Il est ramené à 0 en sandbox, pour que vous puissiez déposer et décaisser dans la même séance de tests.
L'endpoint répond 404 si votre compte n'est pas en mode wallet, et 403 si la clé utilisée n'appartient pas à un marchand. Rappel : sur un compte en mode wallet, customer.account_ref est obligatoire à chaque encaissement, sans quoi le dépôt est refusé en 422 PLAYER_REF_REQUIRED — c'est lui qui lie le dépôt au client, puis le décaissement au numéro qui a déposé.
Webhooks
ElyonPay peut notifier votre serveur en temps réel à chaque changement d'état d'une transaction, via une requête HTTP POST (serveur à serveur). Les webhooks sont optionnels : ils complètent le modèle pull (polling) mais ne le remplacent pas.
Activer les webhooks
Aucune configuration globale n'est nécessaire : l'URL de webhook se fournit transaction par transaction, via le paramètre optionnel webhook lors de la création du paiement. L'URL doit être une URL HTTPS valide et accessible publiquement.
curl -X POST https://api.elyonpay.org/api/request-to-pay/payment/link \
-H "Authorization: Bearer <your_jwt_token>" \
-H "Content-Type: application/json" \
-H "language: fr" \
-d '{
"amount": 15000,
"user_lang": "fr",
"msisdn": "+237600000000",
"success": "https://yoursite.com/success",
"error": "https://yoursite.com/error",
"webhook": "https://yoursite.com/webhooks/elyonpay"
}'Événements notifiés
Une notification est envoyée à chaque fois que la transaction atteint l'un des états suivants :
| Événement | État | Description |
|---|---|---|
| transaction.pending | PENDING | Paiement initié, en attente de confirmation |
| transaction.delivered | DELIVERED | Paiement confirmé, fonds transférés au marchand |
| transaction.declined | DECLINED | Paiement refusé par l'opérateur |
| transaction.cancelled | CANCELLED | Paiement annulé par le client ou le système |
Format de la notification
Chaque notification est une requête POST en JSON, accompagnée des en-têtes suivants :
| En-tête | Description |
|---|---|
| Content-Type | Toujours application/json |
| X-Mip-Event | Nom de l'événement (ex. transaction.delivered) |
| X-Mip-Delivery | Identifiant unique de la notification — utilisez-le pour dédupliquer |
| X-Mip-Attempt | Numéro de la tentative (1 à 5) |
Exemple de payload
{
"event": "transaction.delivered",
"created_at": "2026-07-08T18:45:12+02:00",
"data": {
"transaction": "CI032667e43abf11",
"state": "DELIVERED",
"amount": 15000,
"currency": "XAF",
"operation_code": "OP-2026-000123",
"merchant_id": 42,
"external_id": "CMD-2026-0042",
"customer": {
"account_ref": "CLT-1001",
"name": "Jean Mballa",
"email": "jean@example.com",
"phone": "+237670000001"
},
"creation_date": "2026-07-08T18:40:03+02:00",
"validation_date": "2026-07-08T18:44:57+02:00",
"delivery_date": "2026-07-08T18:45:10+02:00"
}
}Le payload reprend vos propres références quand vous les avez fournies à la création : external_id (votre commande) et le bloc customer (votre client final : account_ref, name, email ; phone est le numéro réellement débité). Les clés sont toujours présentes, nulles sinon.
Pour les transactions marketplace (paiement réparti entre plusieurs marchands), le payload contient en plus un tableau data.split listant la part de chaque marchand (merchant_id, amount) — voir Paiements plateforme.
Accusé de réception et retries
Votre serveur doit répondre avec un code HTTP 2xx en moins de 10 secondes. Toute autre réponse (4xx, 5xx, timeout, erreur réseau) est considérée comme un échec et déclenche une nouvelle tentative selon le calendrier suivant :
| Tentative | Délai après l'échec précédent |
|---|---|
| 1 | Immédiate (au changement d'état) |
| 2 | 3 secondes |
| 3 | 30 secondes |
| 4 | 60 secondes |
| 5 | 90 secondes |
Après 5 tentatives infructueuses, la notification est définitivement abandonnée. Le statut de la transaction reste toujours consultable via GET /api/transactions/{uuid}.
Exemple de réception (Node.js / Express)
app.post('/webhooks/elyonpay', express.json(), async (req, res) => {
// 1. Acknowledge immediately — heavy processing must happen async
res.sendStatus(200);
const event = req.headers['x-mip-event']; // e.g. "transaction.delivered"
const deliveryId = req.headers['x-mip-delivery']; // unique per notification
// 2. Deduplicate: the same delivery may be received more than once
if (await alreadyProcessed(deliveryId)) return;
// 3. Verify the state server-side before acting on it
const { transaction } = req.body.data;
const status = await fetch(
'https://api.elyonpay.org/api/transactions/' + transaction,
{ headers: { Authorization: 'Bearer ' + token } }
).then((r) => r.json());
if (status.state === 'DELIVERED') {
await fulfillOrder(transaction);
}
});Bonnes pratiques
- Répondez vite — Renvoyez le code 2xx avant tout traitement long : au-delà de 10 secondes, la notification est considérée comme échouée et sera rejouée.
- Dédupliquez — Stockez l'en-tête X-Mip-Delivery et ignorez les notifications déjà traitées — les retries peuvent provoquer des doublons.
- Vérifiez côté serveur — Utilisez le webhook comme un signal, puis confirmez l'état via GET /api/transactions/{uuid} avant toute action métier.
- Gardez le polling en filet de sécurité — Si votre serveur est indisponible plus de ~3 minutes, la notification est abandonnée : le polling reste la source de vérité.
Décaissements (wallet)
En mode wallet, les dépôts de vos clients ne vous sont pas reversés un par un : ils créditent votre solde chez ElyonPay. Vous en faites ensuite sortir l'argent par API, vers le Mobile Money de vos clients (un retrait, un remboursement) ou vers votre propre compte (votre marge). Ce mode s'adresse aux marchands qui détiennent l'argent de leurs clients et le leur rendent plus tard.
Comment ça marche
- Dépôt. Votre client paie comme pour tout paiement (voir Créer un paiement), avec
customer.account_refsi vous voulez retrouver ses dépôts. Une fois le paiement confirmé par l'opérateur, son montant net des frais est crédité sur votre solde. - Disponibilité. Un dépôt devient décaissable 72 heures après son crédit en production, immédiatement en sandbox. Le délai en vigueur est renvoyé par
GET /api/wallet/balance(release_delay_hours). - Décaissement. Vous nommez le numéro Mobile Money à payer. Il doit vous avoir payé : un dépôt confirmé depuis ce numéro. ElyonPay le paie chez l'opérateur de ce dépôt, Orange Money ou MTN MoMo.
- Montant. Il quitte votre solde dès la demande, et n'y revient que si l'opérateur refuse le virement (statut
FAILED). Le montant demandé est exactement celui qui est envoyé : les frais ont été prélevés au dépôt.
Le numéro à payer
ElyonPay ne garde pas de fiche de vos clients : chaque décaissement dit lui-même où va l'argent, et nous vérifions seulement que ce numéro vous a déjà payé. L'argent ne revient ainsi que vers un numéro qui vous a payé. Un client qui change de numéro dépose depuis le nouveau ; une fois ce dépôt confirmé, ce numéro est payable lui aussi. Un paiement par carte ne rend aucun numéro payable.
account_ref d'un client ne détourne alors rien : c'est vous qui choisissez le numéro.Authentification
Faire sortir de l'argent exige votre clé d'API, et elle seule : créer un décaissement, envoyer un lot ou relancer avec une session du tableau de bord ou un JWT renvoie 403 API_KEY_REQUIRED. Le solde et le journal se lisent avec la clé ou avec la session du titulaire du compte.
Authorization: Bearer pk_live_...Endpoints
| Méthode | Chemin | Rôle |
|---|---|---|
| GET | /api/wallet/balance | Solde, en attente, disponible |
| POST | /api/wallet/payouts | Créer un décaissementClé d'API |
| POST | /api/wallet/payouts/batch | Envoyer un lot de décaissementsClé d'API |
| GET | /api/wallet/payouts | Journal, filtré et paginé |
| GET | /api/wallet/payouts/{id|reference} | Un décaissement |
| POST | /api/wallet/payouts/{id|reference}/retry | Relancer un décaissement FAILEDClé d'API |
Consulter le solde
{
"currency": "XAF",
"balance": 1250000,
"pending_release": 300000,
"available": 950000,
"release_delay_hours": 72,
"as_of": "2026-11-02T17:12:04+00:00"
}| Champ | Description |
|---|---|
| balance | Ce que nous détenons pour vous. |
| pending_release | Dépôts crédités depuis moins de release_delay_hours, pas encore décaissables. |
| available | Ce que vous pouvez décaisser maintenant : balance − pending_release. |
| release_delay_hours | Délai avant qu'un dépôt devienne décaissable. |
| as_of | Instant du calcul, ISO 8601. |
Les montants sont des entiers dans l'unité de la devise (XAF : le franc). Un compte qui n'est pas en mode wallet reçoit 404.
Créer un décaissement
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| reference | string | Requis | Votre identifiant unique du décaissement, 1 à 64 caractères. C'est votre clé d'idempotence : la même demande rejouée sous la même référence rend le décaissement existant au lieu d'en créer un second. |
| beneficiary_type | string | Optionnel | CUSTOMER (défaut) pour un client, MERCHANT pour votre marge, versée sur votre compte de versement enregistré chez ElyonPay. |
| msisdn | string | Conditionnel | Obligatoire pour CUSTOMER : le numéro Mobile Money à payer, sous toute forme (+237 6…, 2376…, 6…). Il doit avoir fait un dépôt confirmé chez vous ; il est payé chez l'opérateur de ce dépôt. |
| account_ref | string | Optionnel | Votre identifiant du client, 64 caractères au plus : une étiquette pour votre journal et vos filtres, jamais ce qui décide où part l'argent. |
| beneficiary_name | string | Optionnel | Nom du bénéficiaire, 128 caractères au plus. Sinon, le nom déclaré au dépôt de ce numéro. |
| amount | integer | Requis | Montant, entier strictement positif, dans l'unité de la devise. |
| description | string | Optionnel | 255 caractères au plus. Selon l'opérateur, reprise dans le SMS reçu par le client. |
| allow_duplicate | boolean | Optionnel | true pour confirmer un doublon détecté (409 DUPLICATE_SUSPECTED). |
| webhook | string | Optionnel | URL https, 500 caractères au plus, qui recevra l'issue du décaissement (voir plus bas). |
curl -X POST https://api.elyonpay.org/api/wallet/payouts \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{
"reference": "PAY-2026-11-000123",
"msisdn": "+237670000101",
"account_ref": "CLT-1001",
"amount": 25000,
"description": "Retrait du 02/11",
"webhook": "https://yoursite.com/elyonpay/payouts"
}'Réponse 201 quand le décaissement est créé, 200 quand la même demande est rejouée : après un timeout, rejouez sans crainte. Une référence déjà prise par une demande différente est refusée (409 REFERENCE_REUSED).
{
"id": "8a6eae66-4c7d-4c96-8683-b56e895f4e28",
"reference": "PAY-2026-11-000123",
"batch_ref": null,
"beneficiary_type": "CUSTOMER",
"account_ref": "CLT-1001",
"beneficiary_name": "Jean Mballa",
"msisdn": "237670000101",
"payment_method": "MTN_MONEY",
"amount": 25000,
"currency": "XAF",
"description": "Retrait du 02/11",
"status": "QUEUED",
"attempt": 1,
"failure_reason": null,
"operator_reference": null,
"created_at": "2026-11-02T20:29:10+00:00",
"updated_at": "2026-11-02T20:29:10+00:00",
"completed_at": null
}| Champ | Description |
|---|---|
| id | Identifiant ElyonPay du décaissement. |
| msisdn, payment_method | Le numéro payé, chiffres seuls avec l'indicatif, et son opérateur (ORANGE_MONEY ou MTN_MONEY), repris de son dépôt. |
| account_ref | Votre étiquette client, si vous l'avez donnée. |
| beneficiary_name | Le nom de la demande, sinon celui déclaré au dépôt (customer.name). |
| status | Voir Cycle de vie ci-dessous. |
| attempt | Numéro de la tentative : 1, puis +1 à chaque relance. |
| failure_reason | Pourquoi un décaissement a échoué ou est en revue. |
| operator_reference | Référence du virement chez l'opérateur, une fois envoyé. |
| completed_at | Date de l'issue finale (SUCCEEDED ou FAILED). |
Envoyer un lot
Pour les paiements de fin de période. Chaque élément de items a les mêmes champs qu'un décaissement seul. batch_ref (64 caractères au plus) regroupe les lignes dans le journal ; le webhook du lot vaut pour chaque ligne, celui d'une ligne l'emporte.
{
"batch_ref": "OCT-2026",
"webhook": "https://yoursite.com/elyonpay/payouts",
"items": [
{ "reference": "OCT-2026-0001", "msisdn": "+237670000101", "account_ref": "CLT-1001", "amount": 12000 },
{ "reference": "OCT-2026-0002", "msisdn": "+237690000102", "account_ref": "CLT-1002", "amount": 40000 },
{ "reference": "OCT-2026-MARGE", "beneficiary_type": "MERCHANT", "amount": 300000 }
]
}Chaque ligne est contrôlée et réservée seule, avec son propre résultat : CREATED, EXISTING (déjà créée, lot rejoué) ou REFUSED avec son erreur. Deux refus portent sur le lot entier et ne créent rien : trop de lignes (BATCH_TOO_LARGE), ou total des nouvelles lignes au-dessus du disponible (BATCH_EXCEEDS_BALANCE). Un lot rejoué après une coupure ne recrée rien.
{
"batch_ref": "OCT-2026",
"results": [
{ "index": 0, "reference": "OCT-2026-0001", "result": "CREATED", "payout": { "id": "3f0c...", "status": "QUEUED" } },
{ "index": 1, "reference": "OCT-2026-0002", "result": "REFUSED", "error": { "error_code": "MSISDN_NOT_ELIGIBLE", "message": "..." } },
{ "index": 2, "reference": "OCT-2026-MARGE", "result": "CREATED", "payout": { "id": "9b27...", "status": "QUEUED" } }
],
"summary": { "total": 3, "created": 2, "existing": 0, "refused": 1 }
}La réponse est 200 même quand des lignes sont refusées : lisez le résultat de chacune.
Suivre vos décaissements
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| status | string | Optionnel | QUEUED, PROCESSING, SUCCEEDED, FAILED ou ON_HOLD. |
| account_ref | string | Optionnel | Les décaissements portant cette étiquette client. |
| batch_ref | string | Optionnel | Les lignes d'un lot. |
| from, to | ISO 8601 | Optionnel | Période de création ; to est exclu. |
| limit, offset | integer | Optionnel | Pagination : limit de 1 à 200 (50 par défaut). |
curl "https://api.elyonpay.org/api/wallet/payouts?status=FAILED&from=2026-10-01&to=2026-11-01&limit=50&offset=0" \
-H "Authorization: Bearer pk_live_..."
{ "items": [ { ... } ], "limit": 50, "offset": 0 }Le plus récent d'abord. Un décaissement se lit aussi seul, par son id ou par votre reference : GET /api/wallet/payouts/PAY-2026-11-000123. C'est la source de vérité : en cas de doute (webhook manqué, timeout), relisez-le.
Relancer un décaissement
Seul un décaissement FAILED se relance (sinon 409 NOT_RETRYABLE). Il garde votre référence, repart en QUEUED avec une nouvelle tentative, et le montant est de nouveau réservé sur votre solde : solde et plafonds sont recontrôlés. Il part vers le numéro de la demande. Réponse 202 avec le décaissement.
Cycle de vie
| Statut | Signification | Solde |
|---|---|---|
QUEUED | Accepté, en attente d'envoi à l'opérateur. | Réservé |
PROCESSING | Envoyé à l'opérateur, en attente de sa réponse. | Réservé |
SUCCEEDED | Payé. Statut final. | Sorti |
FAILED | Refusé par l'opérateur. Statut final, sauf relance. | Rendu |
ON_HOLD | En revue chez ElyonPay : l'opérateur n'a pas donné de réponse certaine, ou un contrôle a bloqué l'envoi. Nous vérifions auprès de l'opérateur et tranchons : payé, rendu ou renvoyé. | Réservé |
Webhooks de décaissement
Avec un webhook dans la demande, ElyonPay envoie un POST JSON à chaque issue. Rien n'est envoyé pour QUEUED ni PROCESSING.
| Événement | Quand | Solde |
|---|---|---|
payout.succeeded | L'opérateur a payé, ou notre revue l'a confirmé. | L'argent est sorti |
payout.failed | L'opérateur a refusé, ou notre revue a établi que rien n'est parti. | Montant rendu, relance possible |
payout.on_hold | Le décaissement passe en revue. | Montant toujours réservé |
Un décaissement en revue reçoit ensuite une seconde notification, payout.succeeded ou payout.failed. data est l'objet décaissement complet, plus merchant_id (votre code partenaire).
{
"event": "payout.succeeded",
"created_at": "2026-11-02T20:36:14+00:00",
"data": {
"id": "8a6eae66-4c7d-4c96-8683-b56e895f4e28",
"reference": "PAY-2026-11-000123",
"account_ref": "CLT-1001",
"amount": 25000,
"currency": "XAF",
"status": "SUCCEEDED",
"operator_reference": "5b1f0c2e-8d3a-4c47-9e21-3f6a7d2b9c10",
"completed_at": "2026-11-02T20:36:14+00:00",
"merchant_id": "PART-EGT-00042"
}
}| En-tête | Description |
|---|---|
| X-Mip-Event | L'événement. |
| X-Mip-Delivery | Identifiant de la notification, le même d'une tentative à l'autre : dédupliquez sur lui. |
| X-Mip-Attempt | Numéro de la tentative. |
Vérifier auprès d'ElyonPay
Le webhook vous prévient, il ne fait pas foi : il n'est pas signé. Avant d'agir, relisez le décaissement par son data.id avec votre clé d'API, et décidez sur le status que renvoie l'API. Une notification qui ne viendrait pas de nous ne provoque ainsi qu'une relecture.
app.post('/elyonpay/payouts', express.json(), async (req, res) => {
res.sendStatus(200); // répondez vite, traitez ensuite
const { data } = req.body;
const answer = await fetch(
'https://api.elyonpay.org/api/wallet/payouts/' + encodeURIComponent(data.id),
{ headers: { Authorization: 'Bearer ' + process.env.ELYONPAY_API_KEY } }
);
const payout = await answer.json();
// Seul le statut relu chez ElyonPay compte.
if (payout.status === 'SUCCEEDED') await markPayoutPaid(payout.reference);
if (payout.status === 'FAILED') await markPayoutFailed(payout.reference);
});Répondez par un code 2xx. Sinon, nous réessayons quatre fois, après 3 s, 30 s, 60 s et 90 s. Une notification manquée ne change rien au décaissement : relisez-le par l'API.
Contrôles et plafonds
Chaque demande est contrôlée avant de réserver quoi que ce soit, puis recontrôlée au moment de l'envoi (compte en revue) :
| Contrôle | Refus |
|---|---|
| Montant au plus égal au plafond par décaissement | AMOUNT_ABOVE_LIMIT |
| Numéro fourni, qui vous a payé, chez Orange Money ou MTN MoMo | MSISDN_REQUIRED, MSISDN_NOT_ELIGIBLE, RAIL_NOT_SUPPORTED |
| Montant au plus égal au disponible | INSUFFICIENT_FUNDS |
| Cumul du jour au plus égal au plafond journalier du wallet | DAILY_LIMIT_EXCEEDED |
| Cumul du jour vers ce numéro au plus égal au plafond journalier par numéro | DESTINATION_DAILY_LIMIT_EXCEEDED |
| Pas le même montant vers le même numéro dans la fenêtre de doublon | DUPLICATE_SUSPECTED |
Vos plafonds (par décaissement, par jour, par numéro et par jour, fenêtre de doublon, lignes par lot) sont fixés dans votre contrat et affichés dans votre tableau de bord. Le jour est le jour civil à Douala. Un décaissement FAILED ne compte plus dans les plafonds ; une relance compte le jour où elle est faite.
Erreurs
Les refus de l'API wallet ont leur propre format : un error_code stable, un message lisible, et les détails utiles au même niveau.
{
"error_code": "INSUFFICIENT_FUNDS",
"message": "The available wallet balance does not cover this payout.",
"available": 950000,
"pending_release": 300000
}| Code | HTTP | Description |
|---|---|---|
| API_KEY_REQUIRED | 403 | Créer, envoyer un lot ou relancer sans la clé d'API du marchand (session du tableau de bord, JWT). |
| OWNER_ONLY | 403 | Lecture des décaissements par un autre utilisateur que le titulaire du compte (un caissier, par exemple). |
| MERCHANT_BLOCKED | 403 | Votre compte est en revue : les décaissements sont suspendus. Contactez-nous. |
| NOT_A_WALLET | 404 | Le compte n'est pas en mode wallet. |
| NOT_FOUND | 404 | Aucun décaissement sous cet id ou cette référence. |
| INVALID_JSON | 400 | Le corps n'est pas un objet JSON (ou, pour un lot, n'a pas de liste items). |
| STATUS_INVALID, FROM_INVALID, TO_INVALID | 400 | Filtre du journal illisible. |
| REFERENCE_REQUIRED, REFERENCE_INVALID | 422 | reference absente, vide ou de plus de 64 caractères. |
| AMOUNT_INVALID | 422 | amount n'est pas un entier strictement positif. |
| AMOUNT_ABOVE_LIMIT | 422 | Montant au-dessus du plafond par décaissement (détail : max_amount). |
| BENEFICIARY_TYPE_INVALID | 422 | beneficiary_type autre que CUSTOMER ou MERCHANT. |
| MSISDN_REQUIRED | 422 | Pas de msisdn pour un décaissement à un client. |
| ACCOUNT_REF_INVALID, BENEFICIARY_NAME_INVALID | 422 | account_ref ou beneficiary_name trop long, ou avec un caractère de contrôle. |
| DESCRIPTION_INVALID, BATCH_REF_INVALID, WEBHOOK_INVALID | 422 | Champ trop long, caractère de contrôle, ou webhook qui n'est pas une URL https. |
| MSISDN_NOT_ELIGIBLE | 422 | Ce numéro ne vous a jamais payé : aucun dépôt Mobile Money confirmé depuis lui (détail : msisdn). |
| RAIL_NOT_SUPPORTED | 422 | Le compte à payer n'est ni Orange Money ni MTN MoMo. |
| MERCHANT_ACCOUNT_MISSING | 422 | Décaissement de marge sans compte de versement enregistré. |
| INSUFFICIENT_FUNDS | 422 | Le disponible ne couvre pas le montant (détails : available, pending_release). |
| DAILY_LIMIT_EXCEEDED | 422 | Plafond journalier du wallet atteint (détails : daily_limit, used_today). |
| DESTINATION_DAILY_LIMIT_EXCEEDED | 422 | Plafond journalier de ce numéro atteint (détails : destination_daily_limit, used_today, msisdn). |
| DUPLICATE_SUSPECTED | 409 | Même montant vers le même numéro dans la fenêtre de doublon (détails : duplicate_of, duplicate_created_at). Renvoyez avec allow_duplicate: true s'il est voulu. |
| REFERENCE_REUSED | 409 | Cette référence porte déjà un décaissement différent (détail : payout). |
| REFERENCE_DUPLICATED_IN_BATCH | 409 | La même référence apparaît deux fois dans le lot. |
| NOT_RETRYABLE | 409 | Seul un décaissement FAILED se relance (détail : status). |
| BATCH_EMPTY, INVALID_ITEM | 422 | Lot sans ligne, ou ligne qui n'est pas un objet. |
| BATCH_TOO_LARGE | 422 | Trop de lignes dans le lot (détail : max_items). Rien n'est créé. |
| BATCH_EXCEEDS_BALANCE | 422 | Le total des nouvelles lignes dépasse le disponible (détails : batch_total, available). Rien n'est créé. |
Dans votre tableau de bord
La rubrique Wallet montre votre solde, vos mouvements et vos décaissements, filtrables par statut, par référence client et par période, avec vos plafonds en vigueur. Le bouton Exporter CSV sort toutes les lignes du filtre (séparateur point-virgule, UTF-8, heures en UTC). Aucun décaissement ne se crée ni ne se relance depuis le tableau de bord : seulement par l'API, avec votre clé.
Tester en sandbox
Même API sur https://api.elyonpay.net/api, avec la clé de votre compte sandbox et sans argent réel. Les dépôts y sont décaissables immédiatement (release_delay_hours vaut 0) : vous pouvez déposer, décaisser, recevoir les webhooks et essayer les refus de l'API (solde, plafonds, doublons) dans la même séance.
Statuts des paiements
Chaque paiement passe par plusieurs statuts au cours de son cycle de vie.
Diagramme des transitions d'état
stateDiagram-v2
[*] --> CREATED
CREATED --> PENDING: Payment initiated
PENDING --> WAITING_FOR_PAYMENT: Awaiting customer
WAITING_FOR_PAYMENT --> ACCEPTED: Payment confirmed
PENDING --> ACCEPTED: Direct approval
PENDING --> REJECTED: Validation failed
PENDING --> DECLINED: Payment issue
WAITING_FOR_PAYMENT --> DECLINED: Payment issue
WAITING_FOR_PAYMENT --> CANCELLED: User cancellation
ACCEPTED --> DELIVERED: Funds transferred
ACCEPTED --> CANCELLED: Administrative action
REJECTED --> [*]
DECLINED --> [*]
CANCELLED --> [*]
DELIVERED --> [*]
Codes d'erreur
En cas d'erreur, l'API retourne un objet JSON avec un code d'erreur machine et un message lisible.
{
"success": false,
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "Le solde Mobile Money du client est insuffisant.",
"http_status": 402
}
}Table des erreurs
| Code erreur | HTTP | Description |
|---|---|---|
| UNAUTHORIZED | 401 | Clé API manquante ou invalide |
| INVALID_AMOUNT | 400 | Montant invalide ou inférieur au minimum autorisé |
| CURRENCY_NOT_SUPPORTED | 400 | Devise non supportée pour ce réseau |
| PHONE_INVALID | 400 | Numéro de téléphone invalide ou non enregistré |
| INSUFFICIENT_FUNDS | 402 | Solde insuffisant côté client |
| OPERATOR_TIMEOUT | 408 | L'opérateur Mobile Money n'a pas répondu dans les délais |
| DUPLICATE_REQUEST | 409 | Requête dupliquée — utiliser Idempotency-Key |
| PAYMENT_NOT_FOUND | 404 | Paiement introuvable |
| PLAYER_REF_REMOVED | 422 | player_ref n'est plus accepté : envoyez customer.account_ref |
| PLAYER_NAME_REMOVED | 422 | player_name n'est plus accepté : envoyez customer.name |
| RATE_LIMIT_EXCEEDED | 429 | Trop de requêtes — réessayez dans quelques secondes |
| INTERNAL_ERROR | 500 | Erreur interne ElyonPay — contactez le support |
Devises supportées
| Code | Devise | Montant minimum | Méthodes |
|---|---|---|---|
XAF | Franc CFA BEAC | 100 XAF | MTN MoMo, Orange Money, Carte |
XOF | Franc CFA BCEAO | 100 XOF | Wave, Moov, Orange Money, MTN, Carte |
EUR | Euro | 0,50 EUR | Carte (Visa, Mastercard), PayPal |
USD | Dollar américain | 0,50 USD | Carte, PayPal |
GBP | Livre sterling | 0,30 GBP | Carte |
NGN | Naira nigérian | 100 NGN | MTN MoMo NG |
KES | Shilling kenyan | 10 KES | Airtel Money |
CDF | Franc congolais | 500 CDF | Airtel Money |
