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
1
Instale o SDK
Instale o SDK de Pagamentos Dodo usando seu gerenciador de pacotes preferido:
- npm
- yarn
2
Configuração específica da plataforma
- iOS
- Android
Execute pod install na sua pasta iOS:
Configuração do Lado do Cliente
1
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
2
Configurar o 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.
3
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 de 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. Consulte nosso Tutorial de Integração de API para exemplos de configuração de backend.
4
Implemente 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 de tema:
'light' ou 'dark'Personalização da Aparência
Você pode personalizar o Checkout Unificado do React Native para combinar com o design do seu aplicativo, modificando cores, fontes e mais através do parâmetro de aparência ao chamarinitPaymentSession().
Personalização de Cores
Cada categoria de cor determina a cor de um ou mais componentes na UI. Por exemplo,primary define a cor do botão de Pagamento.
| Categoria de Cor | Uso |
|---|---|
primary | Cor primária para o botão de Pagamento 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