SDKs & Libraries
SDKs oficiais de backend para TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby e Rust. Essas bibliotecas simplificam as solicitações de API, a autenticação e o tratamento de erros, permitindo que você se concentre em criar excelentes experiências de pagamento.
Mobile Checkout SDKs
Desenvolvendo um app nativo? Abra o checkout hospedado do Dodo e receba um resultado tipado em uma única chamada, no Android, iOS, React Native e Flutter. Eles não contêm uma chave de API.
URLs de ambiente
- Modo de teste:
https://test.dodopayments.com - Modo ativo:
https://live.dodopayments.com
Saiba mais sobre Modo de teste vs Modo ativo.
Gerenciamento e autenticação de chaves de API
1
Access API Keys
Navegue até Developer → API Keys no seu dashboard para gerenciar suas chaves.
2
Generate a New Key
Selecione Add API Key, forneça um nome descritivo e configure o acesso de gravação:
- Enable write access (marcado): permissões completas de leitura e gravação para todas as operações de API
- Enable write access (desmarcado): acesso somente leitura — pode apenas buscar dados (pagamentos, assinaturas, clientes, produtos). Não pode criar ou modificar recursos.
3
Store Your Key Securely
Copie a chave gerada imediatamente e certifique-se de armazená-la com segurança.
4
Authenticate Your API Requests
Use suas chaves de API para autenticar todas as solicitações. Aplique o seguinte formato de autorização:
Formato da resposta
Limites de taxa
Nossa API usa um sistema de limitação de taxa com duas janelas e proteção contra picos. Os limites são aplicados com base no seu método de autenticação e no nível da sua empresa.Limites padrão (nível 0)
Níveis empresariais
Limites de taxa mais altos estão disponíveis para empresas com maiores necessidades de API:Solicitações não autenticadas
As solicitações sem cabeçalhos de autenticação válidos têm seu limite de taxa definido pelo endereço IP:Cabeçalhos de limite de taxa
Monitore seu uso com estes cabeçalhos de resposta:X-RateLimit-Limit- Número máximo de solicitações permitidasX-RateLimit-Remaining- Solicitações restantes na janela atualX-RateLimit-Reset- Momento em que o limite de taxa é redefinido
Quando você excede os limites de taxa, a API retorna uma resposta
429 Too Many Requests. Implemente um backoff exponencial na sua lógica de novas tentativas.Tratamento de erros
Para gerenciar erros com eficácia, consulte as seções Códigos de erro e Falhas de transação para obter orientações detalhadas.Error Codes
Aprofunde-se nos detalhes abrangentes dos erros e em suas resoluções.
Transaction Failures
Obtenha insights sobre problemas comuns de transação e suas soluções.
Webhooks
Receba notificações em tempo real sobre eventos de pagamento. Consulte nosso Guia de Webhooks para obter instruções de configuração.Webhook Guide
Configure webhooks para receber notificações em tempo real e tratar eventos.
Guias relacionados para desenvolvedores
Explore nossos guias abrangentes para entender como implementar os principais recursos usando a API:One-time Payments Integration
Saiba como integrar pagamentos avulsos, sessões de checkout e links de pagamento ao seu aplicativo
Subscription Integration
Guia completo para implementar assinaturas, gerenciar planos e lidar com eventos do ciclo de vida das assinaturas
Usage-Based Billing
Configure medidores e eventos de uso para cobrança medida e modelos de preços baseados no consumo
Webhooks
Receba notificações em tempo real e automatize fluxos de trabalho com eventos de webhook
Checkout Sessions
Crie experiências de checkout hospedado seguras, com personalização completa e recursos avançados