💳 React Native OpenPay SDK

SDK para integrar OpenPay en aplicaciones React Native utilizando un runtime basado en WebView para la tokenización segura de tarjetas.

🚀 Instalación

npm install @gabigonzalez99/react-native-openpay

Dependencias requeridas

Este SDK utiliza react-native-webview, asegúrate de instalarlo:

npm install react-native-webview

Luego:

cd ios && pod install && cd ..

⚙️ Configuración

No se requiere configuración adicional. El SDK funciona mediante un entorno WebView seguro para procesar pagos.

📦 Uso básico

1. Importar el cliente

import { OpenPayClient } from "@gabigonzalez99/react-native-openpay";

2. Inicializar cliente

const client = new OpenPayClient({
  merchantId: "YOUR_MERCHANT_ID",
  publicKey: "YOUR_PUBLIC_KEY",
  isSandbox: true
});

3. Crear token de tarjeta

const token = await client.createToken({
  holder_name: "Juan Pérez",
  card_number: "4111111111111111",
  expiration_year: "25",
  expiration_month: "12",
  cvv2: "123"
});

console.log(token);

🧠 ¿Cómo funciona?

Este SDK:

• Usa un WebView interno para ejecutar OpenPay JS
• Genera tokens seguros (no expone datos sensibles)
• Aísla la lógica de pagos del código nativo

🔐 Seguridad

• Nunca almacenes datos de tarjeta en tu backend
• Usa siempre HTTPS
• Utiliza sandbox para pruebas

🧪 Modo Sandbox

const client = new OpenPayClient({
  merchantId: "YOUR_MERCHANT_ID",
  publicKey: "YOUR_PUBLIC_KEY",
  isSandbox: true
});

📁 Estructura del SDK

src/
 ├── core/
 │    ├── OpenPayClient.ts
 │    └── OpenPayBridge.ts
 ├── webview/
 │    └── WebViewRuntime.tsx
 └── index.ts

⚠️ Notas importantes

• Este SDK depende de react-native-webview
• Compatible con React Native CLI
• No soporta Expo (sin configuración adicional)

🛠 Roadmap

• [ ] Soporte para tokens de cliente
• [ ] Manejo avanzado de errores
• [ ] Validaciones de tarjeta
• [ ] Ejemplo completo de integración

🤝 Contribuciones

Pull requests son bienvenidos. Para cambios mayores, abre primero un issue.

📄 Licencia

MIT

👨‍💻 Autor

Gabriel González @gabigonzalez99

⭐ Soporte

Si este proyecto te ayuda, considera darle una estrella ⭐ en GitHub.