CloudPayments React Native SDK

✨ Возможности

- 💳 Платежная форма — готовая к использованию форма оплаты
- 🔒 Безопасность — шифрование данных карт и соответствие PCI DSS
- 📱 Нативная интеграция — полная поддержка iOS и Android
- 🎨 Кастомизация — гибкие настройки внешнего вида
- ⚡ TypeScript — полная типизация для лучшего DX
- 🌐 Альтернативные способы оплаты — Apple Pay, Google Pay, Tinkoff Pay, СБП, SberPay

💳 Способы оплаты

| Способ оплаты | iOS | Android | Описание |
| ------------------- | --- | ------- | ---------------------------------- |
| 💳 Банковские карты | ✅ | ✅ | Visa, MasterCard, МИР |
| 🍎 Apple Pay | ✅ | ❌ | Быстрая оплата через Touch/Face ID |
| 🤖 Google Pay | ❌ | ✅ | Быстрая оплата через Google |
| 🏦 Tinkoff Pay | ✅ | ✅ | Оплата через приложение Тинькофф |
| ⚡ СБП | ✅ | ✅ | Система быстрых платежей |
| 🟢 SberPay | ✅ | ✅ | Оплата через Сбербанк Онлайн |

🚀 Быстрый старт

$3

``bash
npm install @lmapp/react-native-cloudpayments


или


yarn add @lmapp/react-native-cloudpayments
`

$3

`bash


iOS

cd ios && pod install && cd ..

Android - автолинковка работает автоматически

`

$3

`typescript
import React from 'react';
import { Button, Alert } from 'react-native';
import { usePaymentForm, PaymentService } from '@lmapp/react-native-cloudpayments';

// Инициализация SDK
await PaymentService.init('pk_test_your_public_id');

const PaymentScreen = () => {
const presentPaymentForm = usePaymentForm('pk_test_your_public_id');

const handlePayment = async () => {
try {
const result = await presentPaymentForm({
amount: '1000.00',
currency: 'RUB',
description: 'Покупка товара',
email: 'user@example.com'
});

if (result.success) {
Alert.alert('Успех!', Платеж прошел! ID: ${result.transactionId});
} else {
Alert.alert('Ошибка', result.message);
}
} catch (error) {
Alert.alert('Ошибка', 'Произошла ошибка при обработке платежа');
}
};

return ;
};
`

📋 Требования

- React Native: 0.70.0+
- iOS: 12.0+
- Android: API level 21 (Android 5.0)+
- Node.js: 16.0+

🔧 API

$3

`typescript
// Инициализация SDK
await PaymentService.init('pk_test_your_public_id');

// Запуск платежной формы
const result = await PaymentService.presentPaymentForm({
amount: '1000.00',
currency: 'RUB',
description: 'Покупка товара',
});
`

$3

`typescript
const presentPaymentForm = usePaymentForm('pk_test_your_public_id');

const result = await presentPaymentForm({
amount: '1000.00',
currency: 'RUB',
description: 'Покупка товара',
});
`

$3

`typescript
import {
eventEmitter,
EPaymentFormEventName,
} from '@lmapp/react-native-cloudpayments';

eventEmitter.addListener(EPaymentFormEventName.PAYMENT_FORM, (event) => {
switch (event.action) {
case 'willDisplay':
console.log('Форма готовится к показу');
break;
case 'transaction':
if (event.statusCode) {
console.log('Платеж успешен:', event.transactionId);
}
break;
}
});
`

🧪 Тестирование

$3

| Номер карты | Результат | CVV | Срок |
| --------------------- | --------------- | ----- | ------- |
| 4111 1111 1111 1111 | Успешный платеж | 123 | 12/25 |
| 4000 0000 0000 0002 | Отклонен банком | 123 | 12/25 |
| 4000 0000 0000 0077 | Требует 3DS | 123 | 12/25 |

> ⚠️ Важно: Используйте тестовый Public ID (начинается с pk_test_`) для разработки!

📱 Настройка платформ

$3

1. Минимальная версия: API level 21
2. Network Security Config: Настройте для CloudPayments домена
3. ProGuard: Добавьте правила для CloudPayments SDK

Подробнее: 📖 Настройка Android

$3

1. Минимальная версия: iOS 12.0
2. Apple Pay: Настройте Merchant ID в Xcode
3. URL Schemes: Добавьте схемы для банковских приложений

Подробнее: 📖 Настройка iOS

🔑 Получение ключей

1. Зарегистрируйтесь на cloudpayments.ru
2. Войдите в личный кабинет
3. Перейдите в Настройки → API
4. Скопируйте ваш Public ID

📚 Документация

- 📖 Полная документация
- 🚀 Быстрый старт
- 📱 Настройка платформ
- 💳 Использование
- 💳 Использование платежной формы

🤝 Поддержка

- 📖 Документация CloudPayments
- 💬 Telegram чат
- 🐛 GitHub Issues
- 📧 Техподдержка

📄 Лицензия

MIT License. См. LICENSE для деталей.

👨‍💻 Автор

Создано Leonid Molchanov (@leonidmolchanov) как независимый open-source проект для интеграции с платежной системой CloudPayments.

🙏 Благодарности

- CloudPayments за отличный платежный API
- React Native сообщество
- Всем контрибьюторам проекта

📄 Лицензия

MIT License - свободная лицензия с открытым исходным кодом.

Вы можете свободно использовать, изменять и распространять этот код в коммерческих и некоммерческих проектах. См. LICENSE для деталей.

---

Сделано с ❤️ Leonid Molchanov для React Native разработчиков

⭐ Поставьте звезду на GitHub • 📖 Документация

> 🚀 Автоматическая система релизов: Этот пакет использует автоматизированную систему релизов с conventional commits.