Integración del SDK de React Native
El SDK de Dodo Payments para React Native te permite crear experiencias de pago seguras en tus aplicaciones nativas de Android e iOS. Nuestro SDK proporciona componentes y pantallas de UI personalizables para recopilar detalles de pago.- 📦 Instala nuestro SDK desde NPM
- 📚 Consulta nuestro repositorio de demostración para ejemplos completos de implementación
- 🎥 Mira nuestro video de demostración para ver el SDK de Dodo Payments en acción
Características
Seguridad Simplificada
Recopila datos de pago sensibles de manera segura mientras mantienes la conformidad con PCI
Múltiples Métodos de Pago
Acepta varios métodos de pago para expandir el alcance global
UI Nativa
Pantallas y elementos nativos para Android e iOS
Actualmente, Apple Pay, Google Pay, Cash App y UPI no son compatibles con el SDK de React Native. Estamos trabajando activamente para agregar soporte para estos métodos de pago en futuras versiones.
Instalación
1
Instalar el SDK
Instala el SDK de Dodo Payments usando tu gestor de paquetes preferido:
- npm
- yarn
2
Configuración específica de la plataforma
- iOS
- Android
Ejecuta pod install en tu carpeta de iOS:
Configuración del lado del cliente
1
Obtener la clave publicable
Obtén tu clave publicable desde el panel de Dodo Payments. (Distinta para los modos de prueba y en vivo)
https://app.dodopayments.com/developer/others
2
Configurar el proveedor de pagos
Envuelve tu aplicación con el
DodoPaymentProvider:App.tsx
Necesitarás generar claves API desde tu panel de Dodo Payments. Consulta nuestra guía de generación de claves API para obtener instrucciones detalladas.
3
Crear función de utilidad de pago
Crea una función de utilidad para obtener parámetros de pago desde tu API de backend:
utils/fetchPaymentParams.ts
Esta función asume que tienes un endpoint de API de backend que crea intenciones de pago y devuelve un secreto de cliente. Asegúrate de que tu backend esté correctamente configurado para manejar la creación de pagos. Consulta nuestro Tutorial de Integración de API para ejemplos de configuración de backend.
4
Implementar la pantalla de pago
Crea tu pantalla de pago usando el
useCheckout hook. Aquí tienes una implementación completa:PaymentScreen.tsx
Para ejemplos completos con estilos, manejo de errores y opciones de personalización, consulta nuestros repositorios de demostración:
Opciones de Configuración
Parámetros de Sesión
El secreto del cliente de tu intención de pago, obtenido de la API de pago único o suscripción.
El modo de la sesión de pago (prueba o en vivo).
Opciones de personalización para la apariencia de la hoja de pago
Modo de tema:
'light' o 'dark'Personalización de Apariencia
Puedes personalizar el Checkout Unificado de React Native para que coincida con el diseño de tu aplicación modificando colores, fuentes y más a través del parámetro de apariencia al llamar ainitPaymentSession().
Personalización de Color
Cada categoría de color determina el color de uno o más componentes en la UI. Por ejemplo,primary define el color del botón de Pago.
| Categoría de Color | Uso |
|---|---|
primary | Color primario para el botón de Pago y elementos seleccionados |
background | Color de fondo de la página de pago |
componentBackground | Color de fondo para entradas, pestañas y otros componentes |
componentBorder | Color del borde externo para entradas, pestañas y otros componentes |
componentDivider | Color del borde interno (bordes compartidos) para componentes |
primaryText | Color del texto del encabezado |
secondaryText | Color del texto de etiqueta para campos de entrada |
componentText | Color del texto de entrada (por ejemplo, número de tarjeta, código postal) |
placeholderText | Color del texto de marcador de posición para campos de entrada |
icon | Color para íconos (por ejemplo, botón de cerrar) |
error | Color para mensajes de error y acciones destructivas |
Personalización de Forma
Puedes personalizar el radio de borde, el ancho de borde y la sombra utilizados en toda la interfaz de pago:Personalización Específica de Componentes
Puedes personalizar componentes específicos de la UI como el botón primario (botón de Pago). Estas configuraciones tienen prioridad sobre las configuraciones de apariencia globales:Manejo de Errores
Maneja diferentes estados de pago en tu función de checkout:Escenarios Comunes de Error
Escenarios Comunes de Error
- Problemas de conectividad de red: Asegúrate de tener una conexión a internet estable
- Secreto de cliente inválido: Verifica que el backend esté generando intenciones de pago válidas
- Dependencias faltantes: Instala todas las dependencias requeridas
- Configuración específica de la plataforma: Completa los pasos de configuración de iOS y Android
- Errores de API: Consulta nuestra Referencia de Códigos de Error para un manejo de errores detallado
Consejos de Depuración
Consejos de Depuración
- Habilita el registro de depuración en desarrollo
- Verifica las solicitudes de red a tu backend
- Asegúrate de que las claves API estén configuradas correctamente
- Prueba en ambas plataformas, iOS y Android
- Revisa nuestras Preguntas Frecuentes Técnicas para problemas comunes
- Usa Modo de Prueba vs Modo en Vivo de manera apropiada