Bienvenue dans notre documentation API

🚀 Bictorys Payments API

Bictorys offre une infrastructure financière moderne conçue pour les entreprises et les développeurs, leur permettant de :

encaisser des paiements locaux et internationaux 🌍
collecter des paiements via mobile money et cartes 💳
créer des comptes virtuels
unifier tous leurs flux de paiement avec une seule intégration
💡 Une seule API pour tous les paiements

L’API Bictorys Charges API est conçue pour être universelle :

🌍 Tous les pays supportés
💳 Tous les moyens de paiement (cartes, mobile money…)
🔗 Tous les cas d’usage (facture, lien de paiement, e-commerce, POS)

👉 Un seul endpoint, une seule intégration, tous les paiements.

📦 Endpoint principal

👉 Charges API

Cette API permet d’encaisser :

une facture
un lien de paiement
une commande en ligne
un paiement en point de vente
🔄 Types d’intégration disponibles
⚡ 1. Direct API (Recommandé)

🔥 Le mode le plus puissant et le plus flexible

La Direct API vous permet de créer une expérience de paiement totalement fluide et invisible :

✔️ Le client reste sur votre application
✔️ Aucun redirect, aucune rupture UX
✔️ Paiement en un clic
✔️ Contrôle total du parcours utilisateur
✔️ Bictorys s’efface au profit de votre expérience

👉 Idéal pour :

applications mobiles 📱
plateformes SaaS
checkout personnalisés
🔧 Fonctionnement
Vous collectez les informations de paiement côté frontend
Vous appelez l’API Charges avec payment_type
Vous recevez une réponse JSON avec le statut

👉 Aucun changement de page. Aucun redirect.

🧾 2. Checkout (Simple & rapide)

✔️ Idéal pour démarrer rapidement

Intégration minimale
Page de paiement hébergée par Bictorys
Redirection utilisateur vers une page sécurisée

👉 Utilisation :

appeler l’API Charges sans payment_type
🧩 3. Iframe (à venir)

🚧 En cours de disponibilité

Intégration du formulaire de paiement dans votre page
Expérience intégrée sans redirection

⚠️ Requiert l’inclusion du script :

bictorys.js

🚧

Attention

L'utilisation du direct API pour les paiements avec carte bancaire nécessite au préalable que vous soyez certifié PCI-DSS. Aucune certification n'est demandée pour les paiements avec les mobiles money.

Choisissez le type d'intégration en fonction des besoins spécifiques de votre cas d'utilisation. Dans le doute, nous vous recommandons l'intégration de type checkout

Example d'utilisation de l'API pour un paiement avec l'intégration de type checkout

const data = JSON.stringify({
  "amount": 100,
  "currency": "XOF",
  "country": "SN",
  "successRedirectUrl": "https://example.com/commandes",
  "ErrorRedirectUrl": "https://example.coml/checkout"
});

const xhr = new XMLHt tpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "http://api.dev.bictorys.com/pay/v1/charges?payment_type=orange_money");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("X-Api-Key", "public-e6cf6c1d-3055-42fa-8eb7-c4f69b6fcbc8.7qmgwSXO69IttHNpS9oNg1WeUCOjnarUpa69jLPA5GmH96pe1EEKpUqf13AKbBSA");

xhr.send(data);

curl --request POST \
  --url http://localhost:8089/pay/v1/charges \
  --header 'Content-Type: application/json' \
  --header 'Request-Id: 038b8488-54fb-49c8-8aa1-0b30c1c99ded' \
  --header 'X-Api-Key: public-5a74cf42-1213-4ac8-8d13-5ba74e300e74.JRGOyPDGWDx2PXU6km5pOsVbuLTHTgC8bsqj8ie1BhmtTrcKOYFkF8uZ6B9Bf8Ui' \
  --data '{
  "amount": 100,
  "currency": "XOF",
  "successRedirectUrl": "https://client.co/redirect_url",
  "ErrorRedirectUrl": "https://client.co/redirect_url"
}'