Skip to main content

GitHub Repository

Boilerplate completo de Expo + React Native + Dodo Payments

​
Visão geral

Um boilerplate pronto para produção para integrar Dodo Payments a aplicativos Expo/React Native. Este modelo inclui criação de sessões de checkout, processamento de pagamentos e configuração adequada do TypeScript para ajudar você a começar a aceitar pagamentos rapidamente em seu aplicativo móvel.
Este boilerplate usa o Expo SDK com TypeScript e inclui implementações de exemplo para sessões de checkout e processamento de pagamentos.

​
Pré-requisitos

  • Node.js 18+
  • Expo CLI ou EAS CLI
  • Conta do Dodo Payments (API key do dashboard)
  • iOS Simulator ou Android Emulator (ou dispositivo físico)

​
Início rápido

1

Clone the Repository

Clone o repositório do boilerplate e navegue até o diretório do projeto:
2

Get Your API Credentials

Obtenha suas credenciais no dashboard do Dodo Payments no Test Mode:
  • API Key: acesse Developer → API Keys no seu dashboard
Comece pelo Test Mode para testar sua integração com segurança, sem processar pagamentos reais.
3

Configure Environment Variables

Crie um arquivo .env no diretório raiz:
Adicione suas credenciais do Dodo Payments:
.env
Nunca faça commit do seu arquivo .env no controle de versão. Ele já está incluído em .gitignore.
As variáveis EXPO_PUBLIC_* são incorporadas ao bundle JavaScript distribuído e podem ser lidas por qualquer pessoa que baixe seu app. As chaves da API do Dodo Payments são secrets bearer, portanto use isso somente com uma chave do Test Mode durante o desenvolvimento. Em produção, crie sessões de checkout no seu backend e passe apenas o checkout_url resultante para o app — consulte Mobile Integration.
4

Install Dependencies

Instale os pacotes npm necessários:
5

Start the Development Server

Inicie o servidor de desenvolvimento do Expo:
Escaneie o código QR com o app Expo Go no seu dispositivo ou pressione i para o simulador do iOS ou a para o emulador do Android.
Você já pode começar a criar! O boilerplate inclui telas e componentes de exemplo para ajudar você a entender a integração.

​
O que está incluído

O boilerplate vem com os elementos essenciais pré-configurados:

Checkout Integration

Implementação de exemplo para criar e gerenciar sessões de checkout

Payment Handling

Fluxo de pagamento completo com tratamento de sucesso e erro

TypeScript Support

Configuração completa do TypeScript com definições de tipos adequadas

Expo Router

Configuração de navegação com o Expo Router para um roteamento integrado

​
Estrutura do projeto

​
Próximas etapas

Depois que o boilerplate estiver em execução:
1

Create Your Products

Adicione produtos no seu dashboard do Dodo Payments para habilitar a funcionalidade de checkout.
2

Customize the Integration

Adapte o código de exemplo para atender às necessidades e ao design do seu app.
3

Test on Real Devices

Teste o fluxo de pagamento em dispositivos físicos para garantir que tudo funcione corretamente.
4

Go Live

Quando estiver tudo pronto, alterne para as chaves da API do Live Mode e compile seu app para produção.

​
Compilação para produção

1

Install EAS CLI

2

Configure EAS

3

Build Your App

Para iOS:
Para Android:

​
Recursos adicionais

Mobile Integration Guide

Guia detalhado para implementar pagamentos em apps móveis

Integration Guide

Guia detalhado para implementar pagamentos únicos

API Reference

Explore a documentação completa da API do Dodo Payments

​
Suporte

Precisa de ajuda com o boilerplate?
Última modificação em 17 de agosto de 2026