Integrate payments
into your apps.
Our React Native SDK allows you to accept card payments directly from your mobile applications, securely.
Our SDKs
Choose the SDK that fits your development platform.
Android
Native Kotlin SDK for Android applications.
iOS
Native Swift SDK for iPhone and iPad applications.
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
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);
}
}
};Frequently 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.