Créer une session de paiement
POSThttps://moneaa.com/api/checkout/session
Initialise une session de paiement hébergée sur Monea. La réponse contient un identifiant de session et l'URL vers laquelle vous devez rediriger votre client. Sur cette page, le client choisit son pays (BJ, BF, CI, NE, SN, TG), sélectionne son opérateur Mobile Money et confirme la transaction sur son téléphone.
Durée de validité de 30 minutesChaque session de paiement expire automatiquement au bout de 30 minutes. Le client doit être redirigé vers l'adresse absolue https://moneaa.com + checkoutUrl. Après le paiement, il revient sur votre returnUrl, par exemple https://maboutique.com/merci?depositId=…&reference=CMD-2026-0842&status=completed. Ce retour sert uniquement à l'affichage : n'importe qui peut taper cette adresse à la main. Validez la commande uniquement sur le webhook signé deposit.completed. Tout champ additionnel non documenté (ex. notify_url, operator, customer) provoque un rejet 400.
Paramètres
amountchaîne de chiffresobligatoire
Montant en unités majeures (ex. "12750"). ATTENTION : ce champ DOIT être une chaîne de caractères et non un nombre entier ou décimal (tout nombre produit une erreur 400).currencytexte (3 car.)facultatif
Code devise ISO. Par défaut "XOF" (Franc CFA BCEAO). Seules les devises servies par le catalogue sont acceptées.referencetexte (≤ 120 car.)facultatif
Votre identifiant unique de commande ou de panier. Cette valeur vous est renvoyée intacte dans le webhook de confirmation.descriptiontexte (≤ 500 car.)facultatif
Libellé descriptif affiché au payeur sur la page de paiement sécurisée.customerNametexte (≤ 160 car.)facultatif
Nom complet du client. Permet d'alimenter la colonne « Client » dans votre tableau de bord marchand.feePayer"customer" | "shared"facultatif
Prise en charge des frais de transaction : "customer" (le client règle 100 % des frais, par défaut) ou "shared" (frais partagés : le client paie les frais du partenaire, vous payez les frais Monea déduits de ce que vous recevez). L'ancienne valeur "split_50_50" reste acceptée pour compatibilité ascendante et normalisée en "shared".returnUrlURL HTTPS (≤ 2048 car.)facultatif
Adresse de votre site où renvoyer le client après le paiement (ex. "https://maboutique.com/merci"). Paiement réussi : renvoi automatique au bout d'une seconde. Paiement échoué : le client peut réessayer, ou revenir chez vous par un lien. Monea ajoute à l'adresse les paramètres depositId, reference et status ("completed" ou "failed"). Sans returnUrl, la page propose un bouton vers le site web de votre profil, s'il est renseigné.Exemple
curl -X POST https://moneaa.com/api/checkout/session \
-H "Authorization: Bearer sk_sandbox_fLx_votre_cle_ici" \
-H "Content-Type: application/json" \
-d '{
"amount": "12750",
"currency": "XOF",
"reference": "CMD-2026-0842",
"description": "Pagne wax hollandais, 6 yards",
"customerName": "Afiavi Mensah",
"feePayer": "customer",
"returnUrl": "https://maboutique.com/merci"
}'Réponse
{
"sessionId": "b4e877cb-539c-4860-93a8-65cb4659f816",
"checkoutUrl": "/checkout?session=b4e877cb-539c-4860-93a8-65cb4659f816",
"expiresAt": "2026-10-13T19:27:42.000Z"
}