Intégrez les paiements
dans vos apps.
Notre SDK React Native vous permet d'accepter les paiements par carte directement depuis vos applications mobiles, en toute sécurité.
Nos SDKs
Choisissez le SDK adapté à votre plateforme de développement.
Android
SDK natif Kotlin pour applications Android.
iOS
SDK natif Swift pour applications iPhone et iPad.
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()
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);
}
}
};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.