Passerelle de paiement · Congo
Encaisser sans friction.
API, checkout et Mobile Money. Du sandbox au LIVE.
Carte virtuelle Techline Pay
La carte n’est que le début.
Envoyez de l’argent, encaissez un achat, payez un produit — une carte virtuelle reliée à votre passerelle TEST/LIVE, Mobile Money et ledger.
Parcours d’un paiement
De l’intention au ledger en quatre étapes.
Techline Pay orchestre chaque paiement avec atomicité, idempotence et traçabilité. Voici ce qui se passe sous le capot quand un client règle une commande.
Payment Intent
Votre backend crée une intention de paiement avec le montant exact en unités mineures (BIGINT).
Checkout Session
La session checkout génère une URL hébergée. Le client choisit Mobile Money, carte ou virement.
Confirmation
Le provider confirme. Techline Pay écrit au ledger et envoie l’événement webhook à votre serveur.
Ledger
Débit / crédit atomiques. Solde disponible reconstructible à tout moment depuis l’historique.
Checkout universel
Une page de paiement prête à l’emploi.
Pas besoin de construire votre propre UI de paiement. Techline Pay héberge une page checkout responsive où votre client choisit son moyen de paiement, confirme et reçoit un reçu — pendant que votre backend attend le webhook.
- URL checkout cs_… partageable par SMS, WhatsApp ou e-mail
- Mobile-first — optimisé pour le Congo et l’Afrique
- Personnalisation : description, montant, métadonnées marchand
- Mode TEST avec mock provider (succès, échec, timeout simulés)
Moyens de paiement
Mobile Money, carte, virement, liens.
Une seule intégration API pour accepter plusieurs rails. Le client choisit sur la page checkout ; Techline Pay route vers le provider via une couche abstraite — jamais de logique provider dans votre code.
Mobile Money
Orange Money, M-Pesa, Airtel… via la page checkout. Le client saisit son numéro et confirme sur son téléphone.
Sandbox : montant 1000 = succès
Carte bancaire
Visa / Mastercard via provider connecté. Tokenisation côté provider — Techline Pay ne stocke jamais les PAN.
Sandbox : montant 2000 = échec
Virement
Instructions de virement affichées au client. Réconciliation manuelle ou automatique selon provider.
Sandbox : montant 3000 = pending
Payment Links
Créez un plink_ partageable sans intégration code. Idéal pour factures, dons ou ventes ponctuelles.
Depuis dashboard ou API
Intégration API
REST prévisible, documentation claire, sandbox immédiat.
Authentification Bearer sk_test_ ou sk_live_. Headers Idempotency-Key sur les POST financiers. Réponses JSON avec IDs publics pi_, cs_, plink_, refund_. Explorez l’API depuis le dashboard ou intégrez en curl / Node / PHP / Python.Auth Bearer (sk_test_ / sk_live_), Idempotency-Key, JSON avec IDs pi_ / cs_ / plink_. Intégrez en curl, Node, PHP ou Python.
Créez une session checkout
POST /v1/checkout/sessions avec amount, currency et Idempotency-Key. Réponse : cs_test_…, pi_test_… et checkout_url prêt à ouvrir.POST /v1/checkout/sessions avec amount, currency et Idempotency-Key. Réponse : cs_test_… et checkout_url.
Montant en unités mineures · CDF ou USD · clé idempotente obligatoireUnités mineures · CDF/USD · clé idempotente
Redirigez votre client
Envoyez l’acheteur vers checkout_url. Page hébergée Techline Pay : Mobile Money, carte ou virement — le client choisit, vous n’hébergez rien.Redirigez vers checkout_url. Mobile Money, carte ou virement — page hébergée Techline Pay.
UX optimisée mobile · confirmation visuelle · aucun SDK front requisUX mobile · confirmation · sans SDK front
Confirmez via webhook
Écoutez payment.succeeded sur votre endpoint. Le ledger double-entrée est mis à jour atomiquement — source de vérité unique.Écoutez payment.succeeded. Le ledger est mis à jour atomiquement — source de vérité.
Signature HMAC · retry automatique · logs dans le dashboardHMAC · retry auto · logs dashboard
Réconciliez et remboursez
Consultez soldes, transactions et remboursements depuis le dashboard. Chaque correction = nouvelle écriture ledger, jamais d’écrasement.Soldes, transactions et remboursements dans le dashboard. Corrections = nouvelles écritures.
Balance reconstructible · audit trail append-onlyBalance reconstructible · audit immuable
# 1. Créer une session checkout (TEST)
curl https://api.techlinepay.cd/v1/checkout/sessions \
-H "Authorization: Bearer sk_test_…" \
-H "Idempotency-Key: ord_42_v1" \
-H "Content-Type: application/json" \
-d '{"amount":5000,"currency":"CDF","description":"Commande #42"}'Webhooks
Soyez notifié en temps réel, sans polling.
Configurez votre endpoint dans le dashboard. Techline Pay envoie payment.succeeded, payment.failed, refund.created et plus. Chaque événement est loggé, signé et rejoué en cas d’échec de livraison.
- Signature HMAC pour vérifier l’authenticité
- Retry exponentiel automatique
- Logs consultables dans Developers → Events
- Mode TEST : événements simulés sans argent réel
// Événement reçu après paiement confirmé
{
"id": "evt_test_7k2m…",
"type": "payment.succeeded",
"data": {
"object": {
"id": "pi_test_91c4…",
"amount": 5000,
"currency": "CDF",
"status": "succeeded"
}
}
}
Dashboard marchand
Pilotez volume, soldes, équipe et conformité.
Un dashboard complet style infrastructure mondiale : overview avec graphiques, liste des paiements filtrable, liens de paiement, clés API, webhooks, logs, onboarding KYC/KYB et demande Go Live. Bandeau Test/Live toujours visible.
- Overview : volume 14 jours, taux de succès, soldes available/pending
- Payments, Refunds, Payouts, Customers, Balances
- Developers : API keys, webhooks, events, logs, explorer
- Settings : business, team, compliance, security
Onboarding & Go Live
De sandbox à LIVE, avec conformité intégrée.
Créez votre compte sandbox immédiatement. Pour passer en LIVE, complétez le profil entreprise, les représentants légaux, uploadez les documents KYC/KYB et soumettez une demande Go Live. L’accès production est accordé après revue — jamais automatiquement depuis une checklist technique seule.
- Wizard onboarding : profil, représentants, documents
- Revue compliance par l’équipe plateforme
- LiveAccessRequest traçable avec statuts
- RBAC : owner, admin, developer, compliance
Architecture fintech
Conçu comme une vraie infrastructure financière.
Techline Pay n’est pas un site e-commerce. Chaque choix technique — ledger, idempotence, isolation marchand, audit trail — vise la production et la conformité.
Ledger double-entrée
Chaque mouvement est une écriture immuable. Le solde se reconstruit depuis l’historique — jamais une colonne balance mutable.
Atomicité SQL
lockForUpdate avant tout débit. Transactions isolées pour éviter les race conditions sur les soldes marchands.
Idempotence native
Idempotency-Key sur toute création financière. Relancer une requête réseau ne duplique jamais un paiement.
TEST / LIVE isolés
sk_test_ et sk_live_, environnements séparés. Le sandbox ne touche jamais l’argent réel ni les données LIVE.
KYC / KYB intégré
Onboarding configurable, documents sécurisés, revue conformité avant Go Live. Pas d’accès LIVE automatique.
Webhooks fiables
Événements payment.succeeded, refund.created, payout.paid. Logs, retries et explorer API dans le dashboard.
Questions fréquentes
Tout ce qu’il faut savoir avant de démarrer.
En sandbox, une première session checkout peut être créée en moins de 30 minutes : clé sk_test_, un POST /checkout/sessions, redirection vers checkout_url. Les webhooks et la réconciliation viennent ensuite.
TEST utilise sk_test_ et des providers simulés — aucun argent réel. LIVE nécessite onboarding KYC/KYB validé, clés sk_live_ et providers de production connectés. Les données sont strictement isolées.
Tous les montants sont stockés en BIGINT (unités mineures). 5000 CDF = 5000 en base, jamais de float. Le ledger enregistre chaque mouvement en double-entrée.
Oui. Passez un Idempotency-Key unique par opération financière. Techline Pay retourne la même réponse si la clé a déjà été traitée — pas de double débit.
Complétez le profil entreprise, les représentants légaux, les documents KYC/KYB, puis soumettez une demande Go Live. L’accès LIVE est accordé après revue conformité — jamais automatiquement.
Mobile Money, carte et virement bancaire via la page checkout universelle. En sandbox, un mock provider simule succès, échec, pending et timeout selon le montant test.
Prêt à tester en sandbox ?
Créez un compte en 2 minutes. Générez votre clé sk_test_, créez votre première session checkout et simulez un paiement Mobile Money.
Accès marchand
Accédez à votre dashboard marchand.
Choisissez connexion ou inscription. Sandbox immédiat en mode TEST.
Connexion
Accédez à votre dashboard marchand TEST ou LIVE.