Callback Moko / PayDRC

Infrastructure de callback pour les transactions Mobile Money

Endpoint de callback

https://xenora-core.base44.app/functions/mokoPayment

Cette URL est envoyée à Moko dans le champ callback_url du payload. Moko appelle cette URL après le traitement de chaque transaction.

Fonctionnement du callback

1Xenora envoie la transaction à Moko avec une référence unique

2Moko traite l'opération (paiement, retrait, etc.)

3Moko appelle le callback Xenora avec le résultat

4Xenora retrouve la transaction par sa référence et la met à jour (idempotent)

SUCCESS

Transaction réussie

PENDING

En attente

FAILED

Échec de la transaction

Callbacks récents

Aucun callback reçu pour le moment.

Les callbacks apparaîtront ici quand Moko notifiera Xenora.

Format du payload envoyé à Moko

{
  "merchant_id": "*** (secret serveur)",
  "merchant_secrete": "*** (secret serveur)",
  "amount": "100",
  "currency": "USD",
  "action": "debit",
  "customer_number": "numéro du client",
  "firstname": "Joao",
  "lastname": "Caiembe",
  "email": "contact@xenurl.com",
  "reference": "REF-20260901-000001",
  "method": "mpesa",
  "callback_url": "https://xenora-core.base44.app/functions/mokoPayment"
}

Constantes: merchant_id, merchant_secrete, firstname, lastname, email, callback_url

Variables: amount, currency, action, customer_number, reference, method

Règles: currency toujours MAJUSCULES, action = debit|credit