# YiriwaPay

> Passerelle de paiement Mobile Money pour les commerçants du Burkina Faso, du Sénégal, de Côte d'Ivoire, du Bénin, du Cameroun, du Congo-Brazzaville, de la RD Congo et de la Gambie. Réseaux : Orange Money, Moov Money, MTN MoMo, Wave, Free Money, Airtel Money, M-Pesa, Afrimoney et QMoney. API REST en JSON, liens de paiement, tableau de bord, mode test sans argent réel. Tous les montants sont des entiers, sans décimales : F CFA (XOF), F CFA d'Afrique centrale (XAF) pour le Cameroun et le Congo-Brazzaville, franc congolais (CDF) pour la RD Congo, dalasi (GMD) pour la Gambie.

À savoir avant d'écrire du code :
- La clé secrète (sk_test_… ou sk_live_…) se met uniquement sur le serveur du marchand, jamais dans une application mobile ou une page web.
- Le client paie sur la page `checkout_url` renvoyée à la création du paiement : redirigez-le vers cette adresse.
- Le retour du client sur `success_url` ne prouve pas qu'il a payé. Avant de livrer, confirmez avec une notification signée (webhook) ou avec GET /payments/{id} : `status` doit valoir `succeeded`.
- Envoyez l'en-tête `Idempotency-Key` (une valeur unique par commande) pour qu'un nouvel essai ne crée pas un second paiement.
- Limite : environ 100 requêtes par minute et par clé. Au-delà : 429 rate_limited avec l'en-tête Retry-After ; rien n'a été fait, vous pouvez rejouer la requête.
- Montant d'un paiement : de 200 F à 1 000 000 F.

## Documentation

- [Documentation de l'API](https://yiriwapay.com/docs): démarrage rapide, authentification, création et lecture d'un paiement, statuts, notifications signées (webhooks) avec exemples Node.js, PHP et Python, idempotence, limites de requêtes, erreurs, mode test, frais.
- [Spécification OpenAPI](https://yiriwapay.com/api/v1/openapi.json): description complète et lisible par machine des points d'accès.
- [Tarifs](https://yiriwapay.com/#tarifs): frais par pays et par réseau.
- [Démo](https://yiriwapay.com/demo): deux vidéos (ouvrir un compte et vérifier son identité ; créer un lien de paiement, utiliser l'API et encaisser) et essais interactifs simulés, sans argent réel.

## Points d'accès (base : https://yiriwapay.com/api/v1)

- POST /payments: crée un paiement ; renvoie checkout_url.
- GET /payments: liste vos paiements (limit, starting_after, status, reference).
- GET /payments/{id}: lit un paiement (source de vérité).
- POST /payments/{id}/cancel: annule un paiement que le client n'a pas commencé à payer.
- GET /balance: soldes disponible (retirable) et en cours de règlement.

Authentification : `Authorization: Bearer sk_test_…`. Erreurs : `{ "error": { "code": "…", "message": "…" } }`.

## Optionnel

- [Conditions d'utilisation](https://yiriwapay.com/conditions)
- [Politique de confidentialité](https://yiriwapay.com/confidentialite)