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

• URl de l'application https://shopify.bictorys.com/

• Redirection https://shopify.bictorys.com/auth/shopify/callback

• Les champs dans le modal sont optionnels, Ne rien ajouter !

• Enregistrer → Installer l'application👌

❗️

Très Important

Après installation, dans l'onglet Parametres 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

Créez un compte sur https://dashboard.bictorys.com

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

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

  
• 
  

Étape 3 — Onboarding Bictorys Gateway

URL : https://www.shopify.bictorys.com/

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

• Step 2 : Collez votre Client ID et Client Secret precedement copié sur 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

4. 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 :

Mobile Money et Cartes Bancaires

3. Dans Instructions de paiement Insérez le texte ci-dessous :

✅ Vous allez recevoir un email avec le lien de paiement Bictorys.

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.

4. 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]