Integrate payments
into your apps.
Open-source SDKs for your payment terminals, plus online options: payment links, API and e-commerce modules.
Payment terminal SDKs
Open-source SDKs to drive the terminal from your POS software, on every platform.
Terminal emulator
Build and test without a physical terminal: the emulator reproduces the payment terminal on your machine.
Features
A modern and complete SDK to integrate payments via the national interbank network.
TypeScript
Full type definitions for better developer experience and fewer errors.
PCI-DSS security (NAPS)
Automatic card number masking (first 6 + last 4 digits).
Receipts
Parsing and formatting of merchant and customer receipts with TKpay branding.
Async/Await
Modern Promise-based API for clean and readable code.
Easy to integrate
A few lines of code are all you need to accept payments.
- Install the package via npm or yarn
- Configure the terminal IP and port
- Process payments with 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);
}
}
};Also get paid online
No-code payment links, an API for your sites and apps, and e-commerce modules on the way.
Payment links & QR
Create a link from your dashboard and send it by WhatsApp, SMS or email — no development required.
Learn morePayment API
Integrate online payments into your website or app through our secure REST API.
Contact usE-commerce modules
WooCommerce, PrestaShop, PHP and Node.js: ready-to-install modules for your store.
Get notifiedFrequently Asked Questions
Find answers to the most common questions about integrating TKpay payments into your applications.
What are the prerequisites for integrating the TKpay SDK?
To integrate the TKpay SDK, you need a TKpay payment terminal connected to the national interbank payment network, a React Native development environment (or native Android/iOS coming soon), and a local network connection between your application and the terminal. The SDK is available via npm and installs with a single command. Our comprehensive documentation on GitHub walks you through the initial setup step by step.
How do webhooks and real-time notifications work?
The TKpay SDK uses an asynchronous architecture based on Promises and callbacks. When a payment is processed, your application immediately receives the result via the REST API, including the authorization code, transaction status and receipt data. You can configure server-side webhooks to receive real-time notifications on payment statuses and automatically synchronize your dashboard.
Is the SDK compatible with my existing POS system?
Yes, the TKpay SDK is designed to easily integrate with any POS system or business application. The REST API is platform-agnostic: you can call it from any language (JavaScript, Python, PHP, etc.). For mobile applications, the React Native SDK provides native integration. Android (Kotlin) and iOS (Swift) SDKs will be available soon for native development.