WooCommerce

L’extension Fofo Express for WooCommerce relie votre boutique WordPress à votre compte Fofo Express. Le client voit le prix de la livraison au paiement, la livraison est créée depuis la commande et son statut s’affiche dans WooCommerce.

PrérequisCopier le lien

• Un compte boutique Fofo Express validé (app mobile ou fofoexpress.com).
• WordPress 6.4 ou plus, PHP 8.1 ou plus, WooCommerce actif.
• La devise de la boutique en franc CFA (XOF).

InstallationCopier le lien

En attendant sa publication sur WordPress.org, l’extension s’installe depuis son fichier zip :

Télécharger Fofo Express for WooCommerce (version 0.1.0, zip)

1. Dans WordPress, ouvrez Extensions › Ajouter › Téléverser une extension, choisissez le zip, installez puis activez l’extension.
2. Dans votre espace web Fofo Express, ouvrez Développeurs › Clés API et créez une clé avec les droits livraisons et devis (voir Authentification).
3. Dans WooCommerce › Réglages › Fofo Express, collez la clé, enregistrez, cliquez sur Tester la connexion puis choisissez votre point d’enlèvement.
4. Dans WooCommerce › Réglages › Expédition, ajoutez le mode Fofo Express à la zone qui couvre le Bénin.
5. Facultatif, pour des mises à jour immédiates : configurez le webhook (voir plus bas).

Au paiementCopier le lien

Le mode de livraison Fofo Express propose au client la liste des quartiers desservis et, si vous l’activez, une carte : il place un repère à sa porte ou utilise sa position actuelle.

• Avec un repère, le prix est exact et le livreur est appelé sans attendre le client.
• Sans repère, Fofo Express envoie au client un lien WhatsApp pour partager sa position avant d’appeler un livreur.

Le prix affiché peut suivre la grille Fofo Express du quartier ou un forfait de votre choix, avec ajustement, arrondi et gratuité au-delà d’un montant. La carte peut être désactivée, facultative ou obligatoire. L’extension fonctionne avec le paiement en blocs et le paiement classique. Une adresse hors des zones desservies est refusée au paiement.

Dans vos commandesCopier le lien

Envoi automatique : la livraison est créée dès que la commande atteint le statut choisi (réglage Envoyer automatiquement au statut).

Validation manuelle : cochez Je valide chaque commande avant qu’un livreur soit appelé. Les commandes vous attendent ; envoyez-les avec Envoyer à Fofo Express depuis la commande, ou en masse depuis la liste.

L’encadré Fofo Express de la commande affiche le statut et la progression, le code d’enlèvement à donner au livreur, le nom et le téléphone du livreur, le montant à encaisser, et permet d’annuler ou de renvoyer après un échec. Chaque étape ajoute une note à la commande, qui passe à Terminée une fois livrée.

La liste des commandes gagne une colonne Livraison.

Paiement à la livraisonCopier le lien

Choisissez les moyens de paiement WooCommerce pour lesquels le livreur encaisse le total de la commande, puis le mode d’encaissement :

• Paiement sécurisé : le client paie par mobile money, Fofo Express vous reverse la vente.
• Paiement direct : le client vous paie directement.

AlertesCopier le lien

Vous recevez un email quand une livraison échoue, est annulée ou expire.

Pour vos clientsCopier le lien

Le client suit sa livraison dans Mon compte et dans les emails WooCommerce. Il reçoit aussi le lien de suivi et le code de remise par WhatsApp.

WebhooksCopier le lien

Sans webhook, les livraisons en cours sont actualisées toutes les 10 minutes. Pour des mises à jour immédiates :

1. Copiez l’adresse du webhook affichée dans les réglages de l’extension.
2. Dans votre espace web Fofo Express, Développeurs › Webhooks, ajoutez cette adresse avec tous les événements delivery.* et payment.confirmed.
3. Collez le secret de signature dans l’extension.

Les envois sont signés comme décrit dans Webhooks.

SandboxCopier le lien

Choisissez l’environnement Sandbox dans les réglages et utilisez une clé de la sandbox : les livraisons sont confiées à un livreur simulé, sans message ni paiement réel (voir Sandbox). Repassez en Production avec une clé de production pour ouvrir le service à vos clients.

Données envoyéesCopier le lien

• API Fofo Express : au calcul du prix, le point d’enlèvement et le quartier ou le repère du client ; à la création, nom, prénom et téléphone du client, position et repère, adresse, numéro de commande, articles et quantités, note du client et montant à encaisser.
• Tuiles OpenStreetMap, si la carte est activée : le navigateur du client charge les images de la carte depuis OpenStreetMap.

Questions fréquentesCopier le lien

Faut-il des webhooks ? Non. Ils rendent seulement les mises à jour immédiates.

Que se passe-t-il si le client ne place pas de repère ? Il reçoit un lien WhatsApp pour partager sa position avant qu’un livreur soit appelé.

Puis-je vérifier chaque commande avant l’appel d’un livreur ? Oui, avec la validation manuelle.