Visão Geral dos SDKs Oficiais - Dodo Payments Documentation

Dodo Payments fornece SDKs oficiais para várias linguagens de programação, cada um projetado com as melhores práticas específicas da linguagem e recursos modernos para uma integração de pagamento sem problemas.

Sempre use a versão mais recente do SDK para ter acesso aos recursos e melhorias mais recentes. Verifique regularmente o gerenciador de pacotes para atualizações e garantir o acesso a todas as capacidades da Dodo Payments.

SDKs Disponíveis

Escolha o SDK que corresponde à sua pilha tecnológica:

TypeScript SDK

Integração com tipagem forte para TypeScript e Node.js com API baseada em promises e autopaginação

Python SDK

Interface pythonica com suporte a async/await para aplicações Python 3.7+

PHP SDK

SDK compatível com PSR-4 para aplicações modernas em PHP 8.1+

Go SDK

Interface idiomática Go com suporte a context e tipagem forte

Ruby SDK

Interface Ruby elegante seguindo convenções e melhores práticas do Ruby

Java SDK

SDK robusto e seguro para threads em Java 8+ com suporte a Maven e Gradle

Kotlin SDK

SDK moderno em Kotlin com corrotinas, segurança contra nulos e funções de extensão

C# SDK

SDK com tipagem forte para .NET 8+ com API baseada em async Task (Beta)

Rust SDK

SDK orientado a async construído sobre Tokio e reqwest com tipagem forte para Rust 1.75+

CLI

Interface de linha de comando para interagir com a API pelo seu terminal

Criando um app móvel? Veja abaixo os Mobile Checkout SDKs para Android, iOS, React Native e Flutter.

Início Rápido

Comece com qualquer SDK em minutos:

Install the SDK

Use o gerenciador de pacotes da sua linguagem para instalar o SDK

TypeScript/Node.js
Python
PHP
Go
Rust

npm install dodopayments

pip install dodopayments

composer require dodopayments/client

go get github.com/dodopayments/dodopayments-go

cargo add dodopayments

Initialize the Client

Configure o cliente com sua chave de API

TypeScript
Python
PHP
Go
Rust

import DodoPayments from 'dodopayments';
const client = new DodoPayments({ bearerToken: 'your_api_key' });

from dodopayments import DodoPayments
client = DodoPayments(bearer_token="your_api_key")

use Dodopayments\Client;
$client = new Client(bearerToken: 'your_api_key');

import "github.com/dodopayments/dodopayments-go"
client := dodopayments.NewClient(option.WithBearerToken("your_api_key"))

use dodopayments::Client;
let client = Client::from_env()?; // reads DODO_PAYMENTS_API_KEY

Sempre armazene suas chaves de API de forma segura usando variáveis de ambiente. Nunca as insira no controle de versão.

Make Your First API Call

Crie uma sessão de checkout ou pagamento

Você está pronto para processar pagamentos! Visite as páginas individuais dos SDKs para guias detalhados e exemplos.

Principais Funcionalidades

Todos os SDKs de backend compartilham estes recursos essenciais. Os Mobile Checkout SDKs abaixo são deliberadamente mais restritos — eles não armazenam nenhuma API key e nunca chamam a API:

Segurança de Tipagem: Tipagem forte para segurança em tempo de compilação e melhor suporte em IDE
Tratamento de Erros: Tratamento abrangente de exceções com mensagens de erro detalhadas
Autenticação: Autenticação simples de chave de API com suporte a variáveis de ambiente
Suporte a Async: Padrões modernos de async/await onde aplicável
Paginação Automática: Paginação automática para respostas de listas
Cobrança Baseada em Uso: Suporte embutido para rastreamento e ingestão de eventos de uso
Teste: Suporte completo para ambiente sandbox para desenvolvimento e testes

Mobile Checkout SDKs

Se você preferir abrir a página de checkout hospedada do Dodo em vez de criar uma interface de pagamento nativa, use o Mobile Checkout SDK da sua plataforma. Os quatro compartilham o mesmo contrato de uma chamada: start(...) retorna um CheckoutResult tipado, nenhum deles armazena uma API key, e Apple Pay/Google Pay funcionam da mesma forma que na web aberta, pois o checkout é aberto na superfície real do navegador da plataforma (SFSafariViewController / Custom Tabs), e não em um WebView:

Android

SDK Kotlin que abre uma Chrome Custom Tab. Requer minSdk 23

iOS

SDK Swift que abre SFSafariViewController. Requer iOS 16+

React Native

Turbo Module sobre os dois núcleos nativos. Requer React Native 0.76+

Flutter

Canal Pigeon sobre os dois núcleos nativos. Requer Flutter 3.44+

Mobile Integration Guide

O fluxo de pagamento móvel de ponta a ponta, desde a sessão de checkout no backend até a configuração do callback scheme

Interface de linha de comando

Para fluxos de trabalho e automação baseados em terminal:

CLI

Interface de linha de comando gerada automaticamente com suporte a todos os 78 endpoints da API

Recursos:

Estrutura de comandos baseada em recursos para uso intuitivo
Vários formatos de saída (JSON, YAML, pretty, interactive)
Autocompletar do shell para bash, zsh e fish
Ideal para scripting e automação de CI/CD

# Quick example
dodopayments payments list --format json | jq '.data[] | {id, amount}'

Migração do Node.js SDK

Migramos do Node.js SDK para o novo TypeScript SDK. Se você estiver usando o Node.js SDK legado, consulte o guia de migração para atualizar sua integração.

Adaptadores de framework

Integre em menos de 10 linhas de código com nossos adaptadores de framework. Escolha entre os frameworks recomendados ou explore todas as opções compatíveis.

Frameworks recomendados

Next.js

Framework full-stack baseado em React com suporte ao App Router

Better Auth

Framework de autenticação com integrações integradas

Supabase

Alternativa open source ao Firebase com Postgres e Auth

Convex

Backend-as-a-Service com recursos em tempo real

Show other 8+ supported frameworks

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Como obter ajuda

Precisa de ajuda com algum SDK?

Discord: entre no nosso servidor da comunidade para obter ajuda em tempo real
E-mail: entre em contato pelo endereço support@dodopayments.com
GitHub: abra uma issue no repositório correspondente do SDK
Documentação: acesse nossa referência da API

Contribuição

Aceitamos contribuições para todos os nossos SDKs! Cada repositório tem um arquivo CONTRIBUTING.md com diretrizes para:

Relatar bugs
Solicitar recursos
Enviar pull requests
Executar testes localmente
Estilo e convenções de código

Visite as páginas individuais dos SDKs para acessar os repositórios no GitHub e as diretrizes de contribuição.

​SDKs Disponíveis

TypeScript SDK

Python SDK

PHP SDK

Go SDK

Ruby SDK

Java SDK

Kotlin SDK

C# SDK

Rust SDK

CLI

​Início Rápido

​Principais Funcionalidades

​Mobile Checkout SDKs

Android

iOS

React Native

Flutter

Mobile Integration Guide

​Interface de linha de comando

CLI

​Migração do Node.js SDK

​Adaptadores de framework

​Frameworks recomendados

Next.js

Better Auth

Supabase

Convex

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

​Como obter ajuda

​Contribuição

SDKs Disponíveis

Início Rápido

Principais Funcionalidades

Mobile Checkout SDKs

Interface de linha de comando

Migração do Node.js SDK

Adaptadores de framework

Frameworks recomendados

Como obter ajuda

Contribuição