Saltar al contenido principal

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.

Características

Simplified Security

Recopila datos de pago sensibles de forma segura mientras cumples con PCI

Multiple Payment Methods

Acepta varios métodos de pago para ampliar el alcance global

Native UI

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 añadir soporte para estos métodos de pago en futuras versiones.

Instalación

1

Install the SDK

Instala el SDK de Dodo Payments usando tu gestor de paquetes preferido:
2

Platform-specific setup

Ejecuta pod install en tu carpeta iOS:

Configuración del lado del cliente

1

Get Publishable Key

Obtén tu clave publicable desde el panel de Dodo Payments. (Distinta para los modos de prueba y producción) https://app.dodopayments.com/developer/others
2

Setup Payment Provider

Envuelve tu app 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 instrucciones detalladas.
3

Create payment utility function

Crea una función auxiliar para obtener parámetros de pago desde tu API backend:
utils/fetchPaymentParams.ts
Esta función asume que tienes un endpoint de API backend que crea intents de pago y devuelve un client secret. 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 del backend.
4

Implement the payment screen

Crea tu pantalla de pago usando el hook useCheckout. Aquí tienes una implementación completa:
PaymentScreen.tsx
Para ejemplos completos con estilo, manejo de errores y opciones de personalización, consulta nuestros repositorios de demostración:

Opciones de Configuración

Parámetros de Sesión

clientSecret
string
requerido
El client secret de tu payment intent, obtenido de la API de pago único o suscripción.
mode
string
requerido
El modo de la sesión de pago (prueba o producción).
configuration.appearance
object
Opciones de personalización para la apariencia del payment sheet
configuration.appearance.themes
string
Modo de tema: 'light' o 'dark'

Personalización de Apariencia

Puedes personalizar el React Native Unified Checkout para que coincida con el diseño de tu app modificando colores, fuentes y más mediante el parámetro appearance al llamar a initPaymentSession().

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 Pay. Configuración de ejemplo con soporte para modo claro y oscuro:

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:
Para aplicar estas personalizaciones, inclúyelas en la configuración de tu sesión de pago:

Manejo de Errores

Maneja diferentes estados de pago en tu función de checkout:
  • Problemas de conectividad de red: Asegura una conexión a Internet estable
  • Client secret inválido: Verifica que el backend esté generando payment intents válidos
  • Dependencias peer faltantes: Instala todas las dependencias requeridas
  • Configuración específica por plataforma: Completa los pasos de configuración para iOS y Android
  • Errores de API: Revisa nuestra Referencia de códigos de error para manejo detallado
  • Habilitar el registro de depuración en desarrollo
  • Verificar las solicitudes de red a tu backend
  • Verificar que las claves de API estén configuradas correctamente
  • Probar en ambas plataformas, iOS y Android
  • Revisar nuestras Preguntas Frecuentes Técnicas para problemas comunes
  • Usar Modo de Prueba vs Modo en Vivo de manera adecuada

Métodos de Pago de Prueba

Utiliza números de tarjeta de prueba en desarrollo para verificar tu integración sin procesar pagos reales. Aprende más sobre nuestro proceso de pruebas y los entornos de prueba disponibles.
Última modificación el 28 de mayo de 2026