Comment encaisser Wave et Orange Money sur une boutique en ligne ?
Boutique hébergée type Shopify ou site sur mesure : liens de paiement sans code, ou API depuis un serveur. Aucune application Shopify 221 Pay n’est publiée.
Une boutique sans serveur modifiable vend avec des liens de paiement ; une boutique avec son propre serveur appelle l’API. Aucune application Shopify ni module de checkout 221 Pay n’est publié : 221 Pay ne s’affiche pas dans le paiement natif d’une plateforme hébergée.
Comparer les deux voies
| Liens de paiement | API | |
|---|---|---|
| Code à écrire | Aucun | Oui, côté serveur |
| Montant | Fixe, saisi à la création du lien | Variable, calculé par la boutique |
| Rapprochement des commandes | Manuel, par payment_link_description | Automatique, par merchant_reference et webhook |
| Convient à | Quelques produits, précommandes, boutique hébergée | Panier dynamique, site sur mesure |
Avec des liens de paiement
Créer un lien par produit
Un lien porte un montant en F CFA et une description de 1 à 80 caractères
(POST /v1/payment-links, ou le tableau de bord). Il est réutilisable : chaque
validation crée un paiement ordinaire. Voir Liens de paiement.
Placer le lien sur la fiche produit
Un bouton « Payer par Wave ou Orange Money » qui ouvre link_to_pay. Le client
choisit son moyen de paiement parmi ceux actifs, saisit son numéro et paie.
Rapprocher les paiements
GET /v1/payments?q=link:<id du lien> renvoie, pour chaque paiement, la
description du lien (payment_link_description). Désactiver un lien quand le
produit n’est plus disponible.
Avec l’API
Le serveur de la boutique crée le paiement à la validation du panier, redirige
vers checkout_url, puis marque la commande payée sur le webhook
payment.succeeded. Mêmes étapes que pour WooCommerce :
WooCommerce, voie 1. Premier appel dans cinq
langages : Comment accepter un premier paiement par API ?
À savoir
- Wave et Orange Money au Sénégal sont actifs par défaut sur un nouveau projet.
- Frais : 2 % par encaissement (Combien coûte 221 Pay ?).
- Un remboursement exige le numéro du client sur le paiement (Remboursements).
Mis à jour le
Comment accepter Wave et Orange Money sur WooCommerce ?
Aucun plugin WooCommerce 221 Pay n’est publié : intégrer l’API depuis le serveur WordPress ou vendre avec des liens de paiement. Étapes et limites.
Comment accepter Wave et Orange Money dans une application Flutter ?
L’application Flutter passe par un serveur qui crée le paiement avec la clé API, puis ouvre checkout_url. La clé ne se place jamais dans l’application.