Paiements

Demander un paiement sans redirection vers le portail Djomy

Cet endpoint permet d’initier un nouveau paiement directement via API, sans passer par la redirection vers notre portail de paiement.

Le paiement est transmis au partenaire. Selon le moyen de paiement choisi, le flux diffère :

• OM et MOMO : Le payeur est notifié par SMS ou via l’application Orange Money / MTN MoMo, afin de confirmer le paiement directement depuis son téléphone.

• KULU : L’API retourne un lien de redirection dans la réponse. Le marchand doit rediriger le payeur vers cette URL :

  • Si l’application KULU est installée, elle s’ouvrira automatiquement pour confirmation.
  • Sinon, le payeur sera redirigé vers le portail web de KULU pour confirmer son paiement.

• VISA et MASTERCARD : ⚠️ Les paiements par carte bancaire ne sont pas autorisés sur cet endpoint. Merci d’utiliser à la place l’API de paiement avec redirection vers notre portail Djomy.

🔒 Sécurité : Cet appel nécessite :

  • Un en-tête Authorization : Bearer <jwt_token>
  • Un en-tête X-API-KEY : clientId:signature

La signature HMAC-SHA256 est calculée de la façon suivante :

signature = HMAC_SHA256(clientId, clientSecret)
X-API-KEY = clientId:signature

Exemple :

X-API-KEY: djomy-merchant-001:ab56b4d92b40713acc5af89985d4b786
post/v1/payments

Request

  • Base URL: https://sandbox-api.djomy.africa
  • URL: https://sandbox-api.djomy.africa/v1/payments
  • Auth: API key in header X-API-KEY and HTTP bearer

Request body

paymentMethodstring required

Méthode de paiement. Valeurs possibles :

  • OM : pour Orange Money
  • MOMO : pour MTN Mobile Money
  • KULU : pour Kulu de Digital Pay
  • SOUTRA_MONEY : pour Soutra Money (Disponible bientôt)
  • PAYCARD : pour PayCard (Disponible bientôt)
  • YMO : pour Ymo (Disponible bientôt)
payerIdentifierstring required

Le numero de compte payeur. Il peut être un numéro de téléphone pour un portefeuille électronique ou une numéro de carte bancaire " + "pour un paiement par carte bancaire. Attention le numéro de téléphone doit au format international. Ex : 00224623707722

⚠ ce champ est obligatoire si le payeur n'est pas à rédiriger vers le portail de paiement de Djomy

amountnumber required

Motant à payer par le payyer. Il doit être un nombre positif

countryCodestring required

Code du pays, Il doit respecter le standard international. ISO (ex : GN pour la Guinée, CI pour le Côte D'Ivoire)

descriptionstring

Description associée au paiement pour donner du contexte

merchantPaymentReferencestring

Indique la reference fournie par le marchand. Celle-ci peut être liée à une référence de commande chez le marchand. Elle n'est pas obligatoire, mais fortement recommandée

returnUrlstring

Url de retour vers le site marchand si paiement effectué avec succès ou non.

Ce champ est obligatoire si le payeur est à rédiriger vers le portail de paiement de Djomy et doit être en htpps.

cancelUrlstring

Url de retour vers le site marchand si le payeur décide de quiter la page de paiement avant soumission du paiement.

Ce champ n'est pas fourni alors le returnUrl sera utilisé. Il doit toutefois être en htpps, s'il est fourni.

metadataobject 
Ce champs optionnel, permet au marchant d'envoyer des informations qu'il souhaitent récupérer dans les webhooks et/ou quand il demande le status d'un paiement
- Il doit être au format JSON et ne contenir ni de list, ni de structure imbriquée
- Ex : { "order_id": "ORD-456", "vip": true, "referrer": "campaign-2026" }

Example request

{
  "paymentMethod": "OM"
}

Response

Paiement initié avec succès

Changes

No recorded changes to this operation across all 1 revision of this API.