Tableau de bordAPI ReferenceObtenir une clé API
Guides

Intégration Shopify — Bictorys Gateway

Intégration de Paiement avec Bictorys : Plugin pour Shopify

Suggest Edits

Bictorys Gateway vous permet d'accepter des paiements Mobile Money (Orange Money, Wave, MTN...) et Cartes Bancaires directement sur votre boutique Shopify. Suivez ce guide pour connecter votre boutique en quelques minutes.


Prérequis

  • Une boutique Shopify active
  • Un compte Bictorys avec une clé privée (Dashboard → Développeurs → Clés privées)
  • Accès Admin de votre boutique Shopify

Étape 1 — Créer une application custom Shopify

  • Admin Shopify → Paramètres → Applications → Développer des applications
    Créer une application → Nom : "Bictorys Gateway"
  • Configuration API Admin → cocher : read_orders, write_orders, read_customers


  • Enregistrer → Installer l'application 👌

Très Important 🔻

  • Après installation, dans l'onglet arametres de l'application, copiez :
    Clé API → c'est votre Client ID
    Clé secrète API → c'est votre Client Secret


Étape 2 — Obtenir votre clé API Bictorys

Dashboard Bictorys → Développeurs → Clé privée

Créer une nouvelle Clé privée en accordant les permissons suivantes :

Copier la clé test_secret-... (Sandbox) ou live_secret-... (Production)


Étape 3 — Onboarding Bictorys Gateway

URL : https://shopify-bictorys-gateway-production.up.railway.app/onboarding

  • Step 1 : Infos boutique (nom, ville, pays, domaine) ensuite cliquez sur Continuer


  • Step 2 : Collez votre Client ID et Client Secret Shopify, puis cliquez Se connecter avec Shopify


  • Step 3 : Clé API Bictorys + URL webhook

La clé API Bictorys collée, suivre les étapes ci-dessous :

  1. S'assurer du Mode (Test ou Production ⚠️)
  2. Copier le Webhook URL
  3. Cliquer sur Activer ma Boutique qui génère la clé Secrète Webhook

  1. Cliquer sur Copier la Clé Webhook Secrète


  • Step 4 : Confirmation 😃

Cliquer sur Confirmer


Étape 4 — Configurer le mode de paiement "Bictorys" dans Shopify


  1. Admin Shopify → Paramètres → Paiements → Fournisseurs tiers
    Ajouter → Nommer le "Bictorys Gateway"
  2. Dans Détails supplementaires Insérez le texte ci-dessous :
Bictorys est une solution de paiement omnicanale sécurisée permettant de régler vos achats via mobile money (Orange Money, Wave, MTN Money) ou carte bancaire.
Simple, rapide et fiable, elle garantit une expérience de paiement fluide adaptée à votre région.
  1. Dans Instructions de paiement Insérez le texte ci-dessous :
Après validation de votre commande :
	1.	Vous recevrez un lien de paiement sécurisé Bictorys.
	2.	Choisissez votre mode de paiement (Mobile Money ou carte bancaire).
	3.	Suivez les instructions pour finaliser la transaction.
	4.	Une confirmation vous sera envoyée une fois le paiement effectué.

⚠️ Votre commande sera traitée uniquement après confirmation du paiement.
  1. Cliquez "Activer"

👍

Flux de paiement client

  1. Le client commande avec le mode Bictorys
  2. Il reçoit un email automatique avec un lien de paiement sécurisé
  3. Il paie via Mobile Money (Orange Money, Wave, MTN…) ou Carte bancaire
  4. La commande est marquée Payée dans Shopify
  5. La référence dans Bictorys affiche le numéro Shopify (ex: Shopify #1025)

Support

Pour toute question : [email protected]

Updated 6 days ago