Aller au contenu principal
SDK & Intégrations

Intégrez les paiements
dans vos apps.

SDKs open source pour vos terminaux de paiement et solutions d'intégration Internet : liens de paiement, API et modules e-commerce.

API
Intégration POS · TPE

SDKs pour terminal de paiement

Des SDKs open source pour piloter le TPE depuis votre logiciel de caisse, sur toutes les plateformes.

Disponible
csharp

.NET / C#

SDK de référence .NET pour caisses et logiciels de point de vente Windows.

GitHub
Disponible
node

Node.js

SDK Node.js pour caisses web et back-offices JavaScript.

GitHub
Disponible
reactNative

React Native

SDK cross-platform pour iOS et Android avec une seule base de code.

GitHub
Disponible
android

Android

SDK natif Kotlin pour applications Android.

GitHub
Disponible
ios

iOS

SDK natif Swift pour applications iPhone et iPad.

GitHub

Émulateur de terminal

Développez et testez sans TPE physique : l'émulateur reproduit le terminal de paiement sur votre machine.

GitHub

Fonctionnalités

Un SDK moderne et complet pour intégrer les paiements via le réseau interbancaire national.

TypeScript

Typage complet pour une meilleure expérience développeur et moins d'erreurs.

PCI-DSS

Masquage automatique des numéros de carte (6 premiers + 4 derniers chiffres).

Reçus

Parsing et formatage des reçus commerçant et client avec branding TKpay.

Async/Await

API moderne basée sur les Promises pour un code propre et lisible.

Simple à intégrer

Quelques lignes de code suffisent pour accepter les paiements.

  • Installez le package via npm ou yarn
  • Configurez l'IP et le port du terminal
  • Traitez les paiements avec processPayment()
Voir la documentation
PaymentScreen.tsx
import {
NapsPayClient,
type PaymentResult,
NapsError,
} from 'react-native-tkpay-naps';

const client = new NapsPayClient({
host: '192.168.24.214',
});

const handlePayment = async () => {
try {
const paymentResult = await client.processPayment({
amount: 100.00,
registerId: '01',
cashierId: '00001',
});

if (paymentResult.success) {
Alert.alert('Success', `Payment approved!`);
} else {
Alert.alert('Failed', paymentResult.error);
}
} catch (error) {
if (error instanceof NapsError) {
Alert.alert('Error', error.message);
}
}
};
Intégration paiement Internet

Encaissez aussi en ligne

Liens de paiement sans code, API pour vos sites et applications, et modules e-commerce à venir.

Disponible

Liens de paiement & QR

Créez un lien depuis votre tableau de bord et envoyez-le par WhatsApp, SMS ou email — aucun développement requis.

Découvrir
Sur demande

API de paiement

Intégrez le paiement en ligne dans votre site ou votre application via notre API REST sécurisée.

Nous contacter
Bientôt

Modules e-commerce

WooCommerce, PrestaShop, PHP et Node.js : des modules prêts à installer pour votre boutique.

Être notifié

Questions fréquentes

Retrouvez les réponses aux questions les plus courantes sur l'intégration des paiements TKpay dans vos applications.

Quels sont les prérequis pour intégrer le SDK TKpay ?

Pour intégrer le SDK TKpay, vous avez besoin d'un terminal de paiement TKpay connecté au réseau interbancaire national, d'un environnement de développement React Native (ou natif Android/iOS à venir), et d'une connexion réseau locale entre votre application et le terminal. Le SDK est disponible via npm et s'installe en une seule commande. Notre documentation complète sur GitHub vous guide pas à pas dans la configuration initiale.

Comment fonctionnent les webhooks et les notifications en temps réel ?

Le SDK TKpay utilise une architecture asynchrone basée sur les Promises et les callbacks. Lorsqu'un paiement est traité, votre application reçoit immédiatement le résultat via l'API REST, incluant le code d'autorisation, le statut de la transaction et les données du reçu. Vous pouvez configurer des webhooks côté serveur pour recevoir des notifications en temps réel sur le statut des paiements et synchroniser votre tableau de bord automatiquement.

Le SDK est-il compatible avec mon système de caisse existant ?

Oui, le SDK TKpay est conçu pour s'intégrer facilement à tout système de caisse ou application métier. L'API REST est agnostique vis-à-vis de la plateforme : vous pouvez l'appeler depuis n'importe quel langage (JavaScript, Python, PHP, etc.). Pour les applications mobiles, le SDK React Native offre une intégration native. Les SDK Android (Kotlin) et iOS (Swift) seront disponibles prochainement pour les développements natifs.

Prêt à intégrer ?

Commencez à accepter les paiements dans votre application dès aujourd'hui.