Aller au contenu principal

Transactions et paiements

GĂ©rez vos paiements et consultez l'historique des transactions.

Aperçu​

Suivez tous vos paiements, factures et votre utilisation sur le tableau de bord des paiements.

Consulter les transactions​

Endpoint : GET /paygate/transactions

Liste toutes vos transactions :

curl -X GET "https://admin.yodi.tg/api/paygate/transactions" \
  -H "Authorization: Bearer YOUR_API_KEY"

RĂ©ponse :

{
  "message": "SUCCESS",
  "error": false,
  "data": [
    {
      "id": "txn_abc123",
      "date": "2026-06-24",
      "amount": 99,
      "currency": "USD",
      "type": "subscription",
      "planName": "Professional",
      "status": "paid",
      "invoiceUrl": "https://..."
    },
    {
      "id": "txn_def456",
      "date": "2026-05-24",
      "amount": 99,
      "currency": "USD",
      "type": "subscription",
      "planName": "Professional",
      "status": "paid",
      "invoiceUrl": "https://..."
    }
  ],
  "status": 200
}

Détails d'une transaction​

Endpoint : GET /paygate/transactions/{id}

Obtenez les détails d'une transaction spécifique :

curl -X GET "https://admin.yodi.tg/api/paygate/transactions/txn_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Factures​

Télécharger une facture​

Endpoint : GET /paygate/transactions/{id}/invoice

Téléchargez une facture PDF pour une transaction :

curl -X GET "https://admin.yodi.tg/api/paygate/transactions/txn_abc123/invoice" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o invoice.pdf

Envoi automatique des factures par e-mail​

Activez la livraison des factures par e-mail dans les paramètres du compte.

Méthodes de paiement​

Méthodes acceptées​

YODI accepte plusieurs méthodes de paiement pour une facturation flexible :

1. Mobile Money​

Paiement instantané depuis votre téléphone

  • Disponible dans les pays africains
  • OpĂ©rateurs : MTN Money, Orange Money, Airtel Money, etc.
  • Confirmation instantanĂ©e
  • Frais de transaction rĂ©duits

2. Carte bancaire​

Paiement sécurisé par carte

  • Visa, Mastercard, American Express
  • Traitement des paiements cryptĂ©
  • Authentification 3D Secure
  • Reçu Ă©mis immĂ©diatement

3. Virement bancaire (Enterprise)​

Pour les gros volumes et les entreprises

  • Virement bancaire direct
  • Facturation mensuelle
  • Conditions de paiement personnalisĂ©es
  • Contacter l'Ă©quipe commerciale

Ajouter un moyen de paiement​

  1. Connectez-vous au tableau de bord
  2. Allez dans Paramètres → Moyens de paiement
  3. Cliquez sur Ajouter un moyen de paiement
  4. Sélectionnez votre méthode de paiement préférée
  5. Suivez les instructions du fournisseur de paiement

Statut du paiement​

Endpoint : GET /paygate/payment-status

Suivez le statut de vos paiements :

  • En attente : Paiement soumis, en attente de confirmation
  • TerminĂ© : Paiement rĂ©ussi
  • ÉchouĂ© : Paiement refusĂ©, rĂ©essayez ou utilisez une autre mĂ©thode
  • ExpirĂ© : Lien de paiement expirĂ© (demandez-en un nouveau)

Devises acceptées​

  • USD (Dollar amĂ©ricain)
  • FCFA (Franc CFA d'Afrique de l'Ouest - XOF)
  • EUR (Euro)
  • GBP (Livre sterling)
  • Devises locales (via les opĂ©rateurs Mobile Money)

Codes promotionnels​

Valider un code promo​

Endpoint : POST /promos/validate

VĂ©rifiez si un code promo est valide :

curl -X POST "https://admin.yodi.tg/api/promos/validate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SAVE50"
  }'

RĂ©ponse :

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "valid": true,
    "code": "SAVE50",
    "discountType": "percentage",
    "discountValue": 50,
    "discountedAmount": 5000
  },
  "status": 200
}

Appliquer un code promo​

Endpoint : POST /promos/apply

Appliquez un code promo Ă  votre compte :

curl -X POST "https://admin.yodi.tg/api/promos/apply" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SAVE50"
  }'

Statut du paiement​

Vérifier le statut du paiement​

Endpoint : GET /paygate/payment-status

curl -X GET "https://admin.yodi.tg/api/paygate/payment-status" \
  -H "Authorization: Bearer YOUR_API_KEY"

RĂ©ponse :

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "status": "completed",
    "method": "mobile_money",
    "currency": "USD"
  },
  "status": 200
}

Remboursements et litiges​

Pour les demandes de remboursement ou les litiges de paiement :

  1. Contactez support@yodi.tg
  2. Fournissez l'ID de transaction
  3. Expliquez le problème
  4. Le support examinera la demande sous 3 jours ouvrés

FAQ​

Q : Quand serai-je facturé ? R : Vous êtes facturé à la date de renouvellement de votre abonnement. La première facturation a lieu immédiatement après la souscription.

Q : Puis-je modifier mon moyen de paiement ? R : Oui, via Paramètres → Moyens de paiement.

Q : Proposez-vous des factures ? R : Oui, toutes les transactions ont des factures téléchargeables.

Q : Quelles devises acceptez-vous ? R : Principalement USD, XOF et d'autres devises majeures selon votre région.

Prochaines étapes​