CloudPayments React Native SDK

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

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

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

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

1. Установка

npm install @lmapp/react-native-cloudpayments
# или
yarn add @lmapp/react-native-cloudpayments

2. Установка зависимостей

# iOS
cd ios && pod install && cd ..

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

3. Использование

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 <Button title="Оплатить 1000 ₽" onPress={handlePayment} />;
};

📋 Требования

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

🔧 API

PaymentService

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

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

usePaymentForm Hook

const presentPaymentForm = usePaymentForm('pk_test_your_public_id');

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

События

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;
  }
});

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

Тестовые карты

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

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

Android

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

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

iOS

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 для деталей.

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

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

0.1.10 (2025-06-23)

🐛 Исправления

• ios-scanner (#14) (359cfca)

0.1.9 (2025-06-23)

✨ Новые возможности

• CardIO support (85a2211)

🐛 Исправления

• eslint (ba25dc6)
• json-data-ios (#13) (f89ffcc)

0.1.8 (2025-06-19)

🐛 Исправления

• android events (b0354b2)

0.1.7 (2025-06-18)

🐛 Исправления

• android data (3a98002)
• ios data form transaction (#8) (6a413ab)
• key import (6a6a7cd)

0.1.6 (2025-06-16)

🐛 Исправления

• js turbomodules spec (aa76e51)

0.1.5 (2025-06-15)

✨ Новые возможности

• improve package discoverability and badges (258f0ef)

0.1.4 (2025-06-15)

✨ Новые возможности

• github release (c785f89)

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

• add automated release system note (0719724)

0.1.3 (2025-06-15)

0.1.2 (2025-06-15)

0.1.1 (2025-06-15)

✨ Новые возможности

• docs (5b23f5b)

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

• add GitHub Pages deployment and documentation setup (f17a66a)
• add GitHub Pages deployment and documentation setup (6d27a50)
• add GitHub Pages deployment and documentation setup (53179b5)

Changelog

Все значимые изменения в этом проекте будут документированы в этом файле.

Формат основан на Keep a Changelog, и этот проект придерживается Semantic Versioning.

[Unreleased]

✨ Новые возможности

• Автоматизированная система релизов с GitHub Actions
• Конвенция коммитов для автоматической генерации changelog
• Документация процесса разработки

🏗️ Сборка

• Добавлен standard-version для автоматического версионирования
• Настроен GitHub Actions workflow для публикации в npm
• Создана конфигурация для автоматической генерации changelog

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

• Добавлено руководство по участию в разработке (CONTRIBUTING.md)
• Обновлена документация с информацией о процессе релизов

Этот файл автоматически обновляется при каждом релизе с помощью standard-version.