WordPress
Installer une extension Jèko, la connecter à votre magasin, et encaisser
Deux extensions, selon que votre site vend ou non.
| Extension | Pour |
|---|---|
| Jèko pour WooCommerce | Une boutique : Mobile Money et lien de paiement au checkout |
| Jèko pour WordPress | Un site sans boutique : dons, boutons de paiement |
Les deux peuvent cohabiter sur un même site, avec les mêmes clés. Il vous faut WordPress 6.0, PHP 8.0, une devise en XOF et un site en HTTPS en production. L'extension boutique demande en plus WooCommerce 8.0.
Avant d'installer
- L'accès API ouvert sur votre compte, voir Activer l'accès à l'API
- Vos clés API, voir Authentification
- Au moins un magasin, voir Gestion des magasins
Télécharger
Version 1.1.0, prête à installer.
| Extension | Fichier |
|---|---|
| Jèko pour WooCommerce | jeko-woocommerce-1.1.0.zip |
| Jèko pour WordPress | jeko-payment-links-1.1.0.zip |
Installer et connecter
Dans Extensions → Ajouter → Téléverser une extension, choisissez le ZIP, installez, activez. WooCommerce doit déjà être actif avant d'activer l'extension boutique.
Ouvrez ensuite l'écran de réglages, WooCommerce → JEKO ou Réglages → JEKO for WordPress selon l'extension. Collez votre API Key et votre API Key ID, tous deux pris dans le Dashboard sous Paramètres → API & Webhooks, puis lancez Test connection & load stores et choisissez votre magasin.
Brancher le webhook
Sans webhook, une commande peut rester en attente alors que le paiement a réussi.
- Copiez l'URL affichée dans les réglages de l'extension,
- Créez l'abonnement magasin dans le Dashboard avec cette URL, voir Intégration des webhooks
- Collez dans WordPress le secret que le Dashboard vous donne
En local, sans HTTPS public, renseignez Public HTTPS URL avec l'adresse d'un tunnel.
Tester
Jèko n'a pas de sandbox : un paiement de test est un vrai encaissement. Utilisez un magasin de test et un petit montant.
Vérifiez que le statut de la commande change après la notification Jèko, pas au retour du navigateur.
Quand ça bloque
| Symptôme | Piste |
|---|---|
| Commande en attente malgré un paiement réussi | L'URL ou le secret du webhook diffèrent entre le Dashboard et WordPress, ou le site n'est pas joignable en HTTPS |
| Le lien de paiement n'apparaît pas au checkout | La commande est sous 100 XOF, le moyen est masqué |
| Devise refusée | La boutique ou le site n'est pas en XOF |
Activez Debug logging dans les réglages, les journaux sont ensuite dans WooCommerce → État →
Journaux, source jeko. Si ça résiste, écrivez à hello@jeko.africa.