Integração do SDK React Native
O SDK React Native da Dodo Payments permite que você crie experiências de pagamento seguras em seus aplicativos nativos para Android e iOS. Nosso SDK fornece componentes e telas de UI personalizáveis para coletar detalhes de pagamento.- 📦 Instale nosso SDK pelo NPM
- 📚 Veja nosso repositório de demonstração para exemplos completos de implementação
- 🎥 Assista ao nosso vídeo de demonstração para ver o SDK de Pagamentos Dodo em ação
Recursos
Segurança Simplificada
Coleta de dados de pagamento sensíveis de forma segura, mantendo a conformidade com PCI
Múltiplos Métodos de Pagamento
Aceite vários métodos de pagamento para expandir o alcance global
UI Nativa
Telas e elementos nativos para Android e iOS
Atualmente, Apple Pay, Google Pay, Cash App e UPI não são suportados no SDK React Native. Estamos trabalhando ativamente para adicionar suporte a esses métodos de pagamento em futuras versões.
Instalação
Instale o SDK
Instale o SDK de Pagamentos Dodo usando seu gerenciador de pacotes preferido:
- npm
- yarn
Configuração do Lado do Cliente
Obtenha a Chave Publicável
Obtenha sua chave publicável no painel da Dodo Payments. (Distinta para os modos de teste e ao vivo)
https://app.dodopayments.com/developer/others
Configurar Provedor de Pagamento
Envolva seu aplicativo com o
DodoPaymentProvider:App.tsx
Você precisará gerar chaves de API no painel da Dodo Payments. Consulte nosso guia de geração de chaves de API para instruções detalhadas.
Crie uma função utilitária de pagamento
Crie uma função utilitária para buscar parâmetros de pagamento da sua API de backend:
utils/fetchPaymentParams.ts
Esta função assume que você tem um endpoint de API backend que cria intenções de pagamento e retorna um segredo do cliente. Certifique-se de que seu backend esteja devidamente configurado para lidar com a criação de pagamentos. Veja nosso Tutorial de Integração da API para exemplos de configuração do backend.
Implementar a tela de pagamento
Crie sua tela de pagamento usando o
useCheckout hook. Aqui está uma implementação completa:PaymentScreen.tsx
Para exemplos completos com estilização, tratamento de erros e opções de personalização, confira nossos repositórios de demonstração:
Opções de Configuração
Parâmetros da Sessão
O segredo do cliente da sua intenção de pagamento, obtido da API de pagamento único ou de assinatura.
O modo da sessão de pagamento (teste ou ao vivo).
Opções de personalização para a aparência da tela de pagamento
Modo do tema:
'light' ou 'dark'Personalização da Aparência
Você pode personalizar o React Native Unified Checkout para combinar com o design do seu aplicativo modificando cores, fontes e mais através do parâmetro appearance ao chamar oinitPaymentSession().
Personalização de Cores
Cada categoria de cor determina a cor de um ou mais componentes na interface do usuário. Por exemplo,primary define a cor do botão Pagar.
| Categoria de Cor | Uso |
|---|---|
primary | Cor primária para o botão Pagar e itens selecionados |
background | Cor de fundo da página de pagamento |
componentBackground | Cor de fundo para entradas, abas e outros componentes |
componentBorder | Cor da borda externa para entradas, abas e outros componentes |
componentDivider | Cor da borda interna (bordas compartilhadas) para componentes |
primaryText | Cor do texto do cabeçalho |
secondaryText | Cor do texto do rótulo para campos de entrada |
componentText | Cor do texto de entrada (por exemplo, número do cartão, código postal) |
placeholderText | Cor do texto de espaço reservado para campos de entrada |
icon | Cor para ícones (por exemplo, botão de fechar) |
error | Cor para mensagens de erro e ações destrutivas |
Personalização de Forma
Você pode personalizar o raio da borda, a largura da borda e a sombra usadas em toda a interface de pagamento:Personalização Específica de Componentes
Você pode personalizar componentes de UI específicos, como o botão primário (botão de Pagamento). Essas configurações têm precedência sobre as configurações de aparência globais:Tratamento de Erros
Trate diferentes estados de pagamento na sua função de checkout:Cenários Comuns de Erro
Cenários Comuns de Erro
- Problemas de conectividade de rede: Garanta uma conexão de internet estável
- Segredo do cliente inválido: Verifique se o backend está gerando intenções de pagamento válidas
- Dependências de pares ausentes: Instale todas as dependências necessárias
- Configuração específica da plataforma: Complete as etapas de configuração do iOS e Android
- Erros de API: Consulte nosso Referência de Códigos de Erro para tratamento de erros detalhado
Dicas de Depuração
Dicas de Depuração
- Ative o registro de depuração em desenvolvimento
- Verifique as requisições de rede para seu backend
- Verifique se as chaves de API estão configuradas corretamente
- Teste em ambas as plataformas iOS e Android
- Revise nossas FAQs Técnicas para problemas comuns
- Use Modo de Teste vs Modo Ao Vivo de forma apropriada