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.
Aucun plugin WooCommerce 221 Pay n’est décrit dans cette documentation : deux voies existent, les liens de paiement (sans code) et l’API appelée par le serveur de la boutique (code PHP à écrire). L’API convient à un panier de montant variable ; les liens conviennent à un prix fixe.
Voie 1 : l’API, pour un panier variable
Créer une clé de test
Tableau de bord, Développeurs > Clés API, portée payments. La clé reste
dans la configuration du serveur WordPress, jamais dans le thème ni dans une
page. Voir Authentification.
Créer le paiement à la validation de la commande
Le serveur envoie POST /v1/payments avec le total de la commande dans
amount, le numéro de commande dans merchant_reference et l’adresse de la
page de retour dans return_url. L’exemple PHP (extension curl) est dans
Comment accepter un premier paiement par API ?.
Rediriger le client
Rediriger vers checkout_url. Le client paie par Wave ou Orange Money, puis
revient sur return_url.
Marquer la commande payée par webhook
Ajouter l’URL d’un point de terminaison de la boutique dans Développeurs >
Webhooks. Sur payment.succeeded, vérifier la signature sur le corps brut,
relire le paiement, puis passer la commande à « payée ». Ne pas se fier à la
seule page de retour : le client peut la fermer. Exemple PHP de
vérification : Webhooks.
Voie 2 : les liens de paiement, pour un prix fixe
Un lien de paiement est une page hébergée par 221 Pay, à montant fixe. Créer
un lien par produit ou par facture, puis le mettre derrière un bouton ou
l’envoyer au client. Le rapprochement avec les commandes WooCommerce reste
manuel : chaque paiement porte payment_link_description, la description du
lien. Voir Liens de paiement.
À vérifier avant la production
- Mode live activé, clé
sk_221_pay_live_rangée dans le gestionnaire de secrets du serveur (Tests, section « Avant la production »). - Une
Idempotency-Keystable par commande. - Identité vérifiée avant le premier retrait : Que faut-il pour commencer et pour retirer ?
- Frais : 2 % par encaissement Wave ou Orange Money au Sénégal (Combien coûte 221 Pay ?).
Mis à jour le
Tableau de bord
Les rubriques du tableau de bord 221 Pay, l’équipe d’un projet et les droits de chaque rôle.
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.