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
Simplified Security
Colete dados sensíveis de pagamento com segurança mantendo a conformidade PCI
Multiple Payment Methods
Aceite diversos métodos de pagamento para expandir o alcance global
Native UI
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 versões futuras.
Instalação
Install the SDK
Instale o SDK da Dodo Payments usando seu gerenciador de pacotes preferido:
- npm
- yarn
Configuração do Lado do Cliente
Get Publishable Key
Obtenha sua chave publicável no painel da Dodo Payments. (Distinta para os modos de teste e produção)
https://app.dodopayments.com/developer/others
Setup Payment Provider
Envolva seu app com o
DodoPaymentProvider:App.tsx
Será necessário gerar chaves de API no painel da Dodo Payments. Consulte nosso guia de geração de chaves de API para instruções detalhadas.
Create payment utility function
Crie uma função utilitária para buscar os parâmetros de pagamento na sua API de backend:
utils/fetchPaymentParams.ts
Esta função pressupõe que você tenha um endpoint de backend que cria intents de pagamento e retorna um client secret. Garanta que seu backend esteja configurado adequadamente para lidar com a criação de pagamentos. Veja nosso Tutorial de Integração da API para exemplos de configuração do backend.
Implement the payment screen
Crie sua tela de pagamento usando o hook
useCheckout. 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 client secret do seu payment intent, obtido pela API de pagamento único ou de assinatura.
O modo da sessão de pagamento (teste ou produção).
Opções de personalização para a aparência da folha de pagamento
Modo do 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 app modificando cores, fontes e mais por meio do parâmetro appearance ao chamarinitPaymentSession().
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 campos, abas e outros componentes |
componentBorder | Cor da borda externa para campos, abas e outros componentes |
componentDivider | Cor da borda interna (bordas compartilhadas) dos componentes |
primaryText | Cor do texto do cabeçalho |
secondaryText | Cor do texto dos rótulos dos campos |
componentText | Cor do texto dos campos (por exemplo, número do cartão, CEP) |
placeholderText | Cor do texto de espaço reservado dos campos |
icon | Cor dos ícones (por exemplo, botão 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:Common Error Scenarios
Common Error Scenarios
- Problemas de conectividade de rede: garanta conexão de internet estável
- Client secret inválido: verifique se o backend está gerando intents de pagamento válidos
- Dependências peer faltando: instale todas as dependências necessárias
- Configuração específica da plataforma: conclua as etapas de configuração do iOS e Android
- Erros da API: consulte nossa Referência de Códigos de Erro para tratamento detalhado de erros
Debugging Tips
Debugging Tips
- Ative o registro em modo debug durante o desenvolvimento
- Verifique as requisições de rede para o seu backend
- Confirme se as chaves de API estão configuradas corretamente
- Teste em plataformas iOS e Android
- Revise nossas Perguntas Frequentes Técnicas para problemas comuns
- Utilize corretamente o Modo de Teste vs Modo Ao Vivo