Skip to main content
O SDK C# fornece acesso conveniente à API REST do Dodo Payments a partir de aplicativos escritos em C#. Ele possui uma API baseada em Tarefas assíncronas com forte tipagem, tentativas automáticas e tratamento de erros abrangente.

Instalação

Instale o pacote do NuGet:
O SDK requer .NET 8.0 ou posterior. Funciona com ASP.NET Core, aplicativos de console e outros tipos de projetos .NET.

Início Rápido

Inicialize o cliente e crie uma sessão de checkout:
Sempre armazene suas chaves da API de forma segura usando variáveis de ambiente, segredos de usuário ou Azure Key Vault. Nunca os codifique diretamente no seu código-fonte ou os envie para o controle de versão.

Recursos Principais

Async/Await

API totalmente assíncrona baseada em Task para operações não bloqueantes

Strong Typing

Segurança abrangente de tipo com tipos de referência anuláveis

Smart Retries

Tentativas automáticas com recuo exponencial para erros transitórios

Error Handling

Hierarquia de exceções integrada para gerenciamento preciso de erros

Configuração

Variáveis de Ambiente

.env

Configuração Manual

Ambientes

Alterne entre modo ao vivo e teste:

Retentativas

O SDK tenta novamente automaticamente 2 vezes por padrão com recuo exponencial. Ele tenta novamente em erros de conexão e códigos de status 408, 409, 429 e 5xx.

Timeouts

As requisições expiram após 1 minuto por padrão.

Substituições por Solicitação

Modifique temporariamente a configuração para uma única solicitação usando WithOptions:

Operações Comuns

Criar uma Sessão de Checkout

Gerenciar Clientes

Manipular Assinaturas

POST /subscriptions (the SDK’s subscriptions.create method) está deprecated. Ele ainda funciona para integrações existentes, mas novas integrações devem criar assinaturas por meio de uma Checkout Session.
Billing exige, no mínimo, o código ISO de duas letras Country. Use AttachExistingCustomer para associar um customer existente ou NewCustomer para criar um. ProductPrice está na menor denominação da moeda.

Tratamento de erros

O SDK lança exceções específicas com base no código de status HTTP. Todos os erros 4xx herdam de DodoPayments4xxException. Outros tipos de exceção:
  • DodoPaymentsIOException: erros de rede de I/O
  • DodoPaymentsInvalidDataException: falha ao interpretar dados analisados
  • DodoPaymentsException: classe base para todas as exceções

Paginação

Paginação automática

Itere por todos os resultados em todas as páginas usando o método Paginate, que retorna um IAsyncEnumerable:

Paginação manual

Integração com ASP.NET Core

Registre o cliente no seu contêiner de DI:
Program.cs
appsettings.json
Para desenvolvimento, use user secrets em vez de armazenar as chaves em appsettings.json:

Recursos

NuGet Package

Ver o pacote na NuGet Gallery

GitHub Repository

Ver o código-fonte e contribuir

API Reference

Documentação completa da API

Discord Community

Obter ajuda e conectar-se com desenvolvedores

Suporte

Precisa de ajuda com o C# SDK?
Última modificação em 17 de agosto de 2026