KPay (sn.kpay) — Intégration API et services OpenFinance

1. API d'autorisation et de session

Reproduit le flux de connexion de l'application KPay : challenge par numéro de téléphone, vérification OTP, liaison d'appareil et jetons de session signés. Sert à lier un utilisateur final une seule fois, puis à appeler les endpoints de solde, de relevé et de paiement depuis votre back-end sans redemander les identifiants. Inclut rotation, révocation et journalisation d'audit.

2. Requête de solde et de relevé

Lit le solde du portefeuille KPay ainsi qu'un grand livre structuré des transactions. Chaque opération porte un type (dépôt, retrait, transfert, paiement marchand, achat de crédit, recharge carte bancaire, transfert international), une contrepartie, un montant en XOF, un statut et une référence. Utilisé pour la réconciliation comptable, l'anti-fraude et la synchronisation ERP.

3. Wallet-to-wallet et transfert international

Soumission programmatique de transferts wallet-to-wallet au sein de KPay et de transferts internationaux sortants sur le corridor CEDEAO. Retourne des clés d'idempotence et des callbacks webhooks pour régler les contre-écritures sans polling. Gère le XOF et le reporting multi-devises.

4. Paiement de factures et achat de crédit

Endpoint unique acceptant un code émetteur (SENELEC, WOYOFAL, péage RAPIDO, eau AQUATECH), une référence de compte et un montant. Retourne le reçu et un webhook succès / échec. Permet d'embarquer le paiement de factures KPay dans des portails SaaS ou des tableaux de bord de gestion locative.

5. Paiement marchand et moteur de cashback

Génération de QR-codes, demandes de paiement marchand dynamiques et rapports de réconciliation pour les points de vente partenaires. Capture les bonus de cashback / promotionnels (par exemple jusqu'à 10 % chez Low Price, dans les stations EDK et Djolof Chicken) afin que les moteurs de fidélité restent exacts.

6. Recharge du portefeuille par carte bancaire

Prend en charge le flux « recharge par Visa / Mastercard » de KPay, y compris l'authentification 3-D Secure lorsque requise, avec une couche de tokenisation propre garantissant que les PAN de cartes ne touchent jamais vos serveurs. Utile pour les rechargements diaspora depuis l'UE / les États-Unis vers un portefeuille KPay sénégalais.

A. Synchronisation comptable PME pour les marchands KPay

Un commerçant utilisant les comptoirs marchands KPay a besoin d'une réconciliation quotidienne dans Sage, Odoo ou QuickBooks. Nous interrogeons l'API de relevé toutes les 15 minutes, normalisons chaque ligne en écriture (débit caisse / crédit ventes, avec ventilation TVA), et la poussons vers l'ERP via REST. Correspond directement aux schémas OpenFinance « account information ».

B. Tableau de bord remittances diaspora

Une startup de remittances opérant sur le corridor UE → Sénégal construit un tableau de bord unifié pour les expéditeurs. Le statut, le taux de change et les frais des transferts internationaux KPay sont récupérés via des API autorisées, joints aux jambes Stripe / SEPA, et présentés sur une chronologie unique. Des webhooks notifient l'expéditeur lorsque les fonds arrivent dans le portefeuille KPay du destinataire.

C. Paiement de factures pour la gestion locative

Un gestionnaire immobilier avec des centaines de locataires à Dakar doit régler les factures Senelec et Woyofal mensuellement. Nous orchestrons l'API de paiement de factures KPay en lot, retentons en cas d'échec transitoire, et produisons un grand livre CSV plus des reçus PDF. Correspond aux schémas OpenBanking « payment initiation » sur un rail mobile-money domestique.

D. Signal anti-fraude pour prêteurs fintech

Un prêteur exploite un export de relevés KPay sur 12 mois comme proxy revenus / dépenses. Nous livrons un JSON normalisé qui scorise la récurrence (cadence des dépôts de salaire, régularité des factures, churn P2P) et alimente le moteur d'underwriting du prêteur. Le consentement et les fenêtres de rétention sont alignés avec l'Instruction BCEAO N°001-01-2024.

E. Programme de fidélité et cashback

Un réseau marchand (par exemple stations EDK + Low Price + Djolof Chicken) souhaite une vue portefeuille cross-enseigne. Les événements de paiement marchand KPay arrivent en streaming via webhook, le moteur de cashback applique les règles de palier, et le client visualise un solde unifié. Les promotions réelles de KPay (jusqu'à 10 % chez les enseignes partenaires) ancrent le modèle de données.

Autoriser une session KPay (pseudo-code)

POST /api/v1/kpay/auth/session
Content-Type: application/json
X-Studio-Key: <PARTNER_KEY>

{
  "msisdn": "+2217xxxxxxxx",
  "device_id": "studio-bridge-01",
  "consent_id": "ct_2026_04_kpay_001",
  "scopes": ["balance.read","statement.read","payment.write"]
}

200 OK
{
  "session_id": "sess_8f...",
  "access_token": "eyJhbGciOi...",
  "expires_in": 1800,
  "refresh_token": "rt_..."
}

Récupérer un relevé de transactions

POST /api/v1/kpay/statement
Authorization: Bearer <ACCESS_TOKEN>

{
  "wallet_id": "user@kpay.sn",
  "from_date": "2026-03-01",
  "to_date":   "2026-03-31",
  "types": ["TRANSFER","BILL","MERCHANT","INTL"],
  "page": 1,
  "page_size": 100
}

Response (truncated):
{
  "currency": "XOF",
  "items": [
    {"id":"tx_01","type":"TRANSFER","amount":-15000,
     "counterparty":"+2217...","ref":"KP-2026-...","ts":"2026-03-02T08:14:01Z"},
    {"id":"tx_02","type":"BILL","biller":"SENELEC",
     "contract":"3214xxx","amount":-22500,"status":"OK"}
  ],
  "next_page": 2
}

Webhook : confirmation de paiement marchand

POST https://your-host/webhooks/kpay
X-KPay-Signature: t=1714400000,v1=...

{
  "event": "merchant.payment.succeeded",
  "merchant_id": "MERCH_LOWPRICE_DKR_03",
  "terminal": "POS-22",
  "amount": 12500,
  "currency": "XOF",
  "cashback": { "rate": 0.05, "amount": 625 },
  "tx_id": "kp_tx_77af...",
  "ts": "2026-04-29T11:02:33Z"
}

// Validate HMAC, ack with 2xx within 5s, otherwise retried with exponential back-off.

Liste des livrables

• Rapport d'autorisation et d'analyse de protocole (session, OTP, chaîne de signature)
• Spécification OpenAPI / Swagger couvrant les endpoints solde, relevé, transfert, factures et marchand
• Code source exécutable en Python ou Node.js (et Go sur demande)
• Templates de gestionnaires webhook avec vérification HMAC
• Harnais de test avec fixtures rejouables et exemples sandbox
• Notes de conformité cartographiées sur l'Instruction BCEAO N°001-01-2024 et la loi sénégalaise sur la protection des données

Deux modèles d'engagement

• Livraison de code source à partir de 300 $ — code API exécutable plus documentation complète ; vous payez après livraison une fois le build validé de bout en bout.
• API hébergée à l'appel — appelez notre endpoint KPay managé et ne payez qu'à la requête, sans coût initial ; idéal pour les équipes recherchant une tarification à l'usage ou un travail de preuve de concept.

À propos de notre studio

Nous sommes un studio technique indépendant spécialisé dans l'analyse de protocole d'applications et l'intégration API autorisée pour les applications fintech, e-commerce, mobilité et OTT. L'équipe combine reverse engineering mobile, ingénierie des rails de paiement et delivery cloud, et nous avons livré des intégrations pour les rails mobile-money UEMOA, des schémas OpenBanking en Europe, l'UPI en Inde et les systèmes de paiement temps réel en Amérique latine.

• Adressé à des clients à l'international, à l'aise avec les standards mobile-money sénégalais et pan-africains
• Implémentations d'interfaces conformes et licites sous autorisation client
• Couverture Android et iOS, avec SDK Python / Node.js / Go et documentation OpenAPI
• Pipeline : cadrage → analyse de protocole → build → validation → transmission de conformité

Contact

Pour un devis, une discussion de périmètre ou pour soumettre votre cas d'usage KPay, ouvrez notre page contact :

Ouvrir la page contact

Déroulé de la mission

1. Confirmation du périmètre : quelles surfaces KPay (login, relevé, transfert, factures, marchand, international) vous sont réellement nécessaires.
2. Analyse de protocole et conception API (2 à 5 jours ouvrés selon le nombre de surfaces).
3. Build et validation interne sur fixtures (3 à 8 jours ouvrés).
4. Documentation, requêtes types et cas de test (1 à 2 jours ouvrés).
5. Première livraison typique : 5 à 15 jours ouvrés ; les approbations du portail développeur KPay ou le provisioning sandbox peuvent allonger les délais.

FAQ

De quoi avez-vous besoin pour démarrer ?

Est-ce licite ?

Comment la confidentialité est-elle préservée ?