Shopify · redirection

NaabigaPay pour Shopify

Une intégration légère par redirection, sans devenir fournisseur de paiement officiel.

À savoir. Shopify ne permet pas d'installer une passerelle de paiement via un simple .zip : une passerelle native est une App soumise à la validation de Shopify (compte Partenaire requis). Cette intégration légère ajoute un bouton « Payer avec NaabigaPay » qui redirige le client vers la page de paiement, puis valide la commande via le webhook signé.

Télécharger le middleware (.zip)

Le principe

Le client passe commande avec une méthode de paiement manuelle « NaabigaPay » (commande en attente).
Un bouton sur la page de statut de commande l'envoie vers votre petit serveur, qui crée un lien de paiement et le redirige vers la page NaabigaPay.
À la confirmation, NaabigaPay envoie un webhook signé ; votre serveur le vérifie et marque la commande payée via l'Admin API Shopify.

Le middleware fourni détient les secrets (clé API, secret webhook, jeton Admin). Ne mettez jamais ces secrets dans le thème Shopify.

1.Déployer le middleware

Le .zip contient un petit serveur Node (Express). Déployez-le sur une URL publique (Render, Railway, un VPS, Dokploy…) avec ces variables :

Bash

npm install
NAABIGA_SECRET=sk_live_... \
NAABIGA_WEBHOOK_SECRET=... \
SHOPIFY_STORE=ma-boutique.myshopify.com \
SHOPIFY_ADMIN_TOKEN=shpat_... \
PUBLIC_URL=https://pay.mondomaine.com \
npm start

2.Configurer Shopify

Méthode manuelle : Réglages › Paiements › Méthodes de paiement manuelles › « NaabigaPay (Mobile Money) ».
App personnalisée : Réglages › Applications › Développer des apps › scope write_orders › copiez le jeton shpat_….
Webhook NaabigaPay : enregistrez https://pay.mondomaine.com/webhook dans le portail, mettez son secret dans NAABIGA_WEBHOOK_SECRET.

3.Ajouter le bouton de paiement

Réglages › Paiement › Scripts additionnels (page de statut de commande) :

Liquid

<a href="https://pay.mondomaine.com/pay?order={{ order.id }}&amount={{ order.total_price | money_without_currency }}"
   style="display:inline-block;padding:12px 18px;background:#E11B22;color:#fff;border-radius:10px;text-decoration:none;font-weight:600">
  Payer avec NaabigaPay
</a>

Fiabilité : la commande n'est marquée payée que par le webhook signé côté serveur, jamais sur le simple retour du navigateur.

Devise : la boutique doit être en FCFA (XOF). Pour un checkout 100 % natif Shopify (passerelle officielle), il faut développer une App Payments et la faire valider par Shopify — dites-le-nous si vous en avez besoin.

Voir aussi la documentation complète et les autres Quickstarts.