> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral dos SDKs Oficiais

> SDKs oficiais para TypeScript, Python, PHP, Go, Ruby, Java, Kotlin, C# e Rust para integrar Dodo Payments em suas aplicações

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.

<Tip>
  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.
</Tip>

## SDKs Disponíveis

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

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/developer-resources/sdks/typescript">
    Integração com tipagem forte para TypeScript e Node.js com API baseada em promises e autopaginação
  </Card>

  <Card title="Python SDK" icon="python" href="/developer-resources/sdks/python">
    Interface pythonica com suporte a async/await para aplicações Python 3.7+
  </Card>

  <Card title="PHP SDK" icon="php" href="/developer-resources/sdks/php">
    SDK compatível com PSR-4 para aplicações modernas em PHP 8.1+
  </Card>

  <Card title="Go SDK" icon="golang" href="/developer-resources/sdks/go">
    Interface idiomática Go com suporte a context e tipagem forte
  </Card>

  <Card title="Ruby SDK" icon="gem" href="/developer-resources/sdks/ruby">
    Interface Ruby elegante seguindo convenções e melhores práticas do Ruby
  </Card>

  <Card title="Java SDK" icon="java" href="/developer-resources/sdks/java">
    SDK robusto e seguro para threads em Java 8+ com suporte a Maven e Gradle
  </Card>

  <Card title="Kotlin SDK" icon="code" href="/developer-resources/sdks/kotlin">
    SDK moderno em Kotlin com corrotinas, segurança contra nulos e funções de extensão
  </Card>

  <Card title="C# SDK" icon="c" href="/developer-resources/sdks/csharp">
    SDK com tipagem forte para .NET 8+ com API baseada em async Task (Beta)
  </Card>

  <Card title="Rust SDK" icon="rust" href="/developer-resources/sdks/rust">
    SDK orientado a async construído sobre Tokio e reqwest com tipagem forte para Rust 1.75+
  </Card>

  <Card title="React Native SDK" icon="mobile" href="/developer-resources/react-native-integration">
    SDK móvel nativo para criar experiências de pagamento seguras em apps iOS e Android
  </Card>

  <Card title="CLI" icon="terminal" href="/developer-resources/sdks/cli">
    Interface de linha de comando para interagir com a API a partir do seu terminal
  </Card>
</CardGroup>

## Início Rápido

Comece com qualquer SDK em minutos:

<Steps>
  <Step title="Install the SDK">
    Use o gerenciador de pacotes da sua linguagem para instalar o SDK

    <Tabs>
      <Tab title="TypeScript/Node.js">
        ```bash theme={null}
        npm install dodopayments
        ```
      </Tab>

      <Tab title="Python">
        ```bash theme={null}
        pip install dodopayments
        ```
      </Tab>

      <Tab title="PHP">
        ```bash theme={null}
        composer require dodopayments/client
        ```
      </Tab>

      <Tab title="Go">
        ```bash theme={null}
        go get github.com/dodopayments/dodopayments-go
        ```
      </Tab>

      <Tab title="Rust">
        ```bash theme={null}
        cargo add dodopayments
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Initialize the Client">
    Configure o cliente com sua chave de API

    <Tabs>
      <Tab title="TypeScript">
        ```typescript theme={null}
        import DodoPayments from 'dodopayments';
        const client = new DodoPayments({ bearerToken: 'your_api_key' });
        ```
      </Tab>

      <Tab title="Python">
        ```python theme={null}
        from dodopayments import DodoPayments
        client = DodoPayments(bearer_token="your_api_key")
        ```
      </Tab>

      <Tab title="PHP">
        ```php theme={null}
        use Dodopayments\Client;
        $client = new Client(bearerToken: 'your_api_key');
        ```
      </Tab>

      <Tab title="Go">
        ```go theme={null}
        import "github.com/dodopayments/dodopayments-go"
        client := dodopayments.NewClient(option.WithBearerToken("your_api_key"))
        ```
      </Tab>

      <Tab title="Rust">
        ```rust theme={null}
        use dodopayments::Client;
        let client = Client::from_env()?; // reads DODO_PAYMENTS_API_KEY
        ```
      </Tab>
    </Tabs>

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

  <Step title="Make Your First API Call">
    Crie uma sessão de checkout ou pagamento

    <Check>
      Você está pronto para processar pagamentos! Visite as páginas individuais dos SDKs para guias detalhados e exemplos.
    </Check>
  </Step>
</Steps>

## Principais Funcionalidades

Todos os SDKs compartilham estas capacidades principais:

* **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

## SDK para React Native

Para aplicativos móveis, oferecemos um SDK dedicado para React Native:

<Card title="React Native SDK" icon="mobile" href="/developer-resources/react-native-integration">
  Crie experiências de pagamento seguras para apps iOS e Android com componentes de UI nativos e coleta simplificada de dados de pagamento
</Card>

**Funcionalidades:**

* Componentes de UI nativos para Android e iOS
* Segurança simplificada para coleta de dados de pagamento sensíveis
* Suporte a múltiplos métodos de pagamento
* Integração perfeita com apps React Native

<Info>
  Apple Pay, Google Pay, Cash App e UPI não são atualmente suportados no SDK para React Native. O suporte para esses métodos de pagamento está planejado para lançamentos futuros.
</Info>

## Interface de Linha de Comando

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

<Card title="CLI" icon="terminal" href="/developer-resources/sdks/cli">
  Interface de linha de comando gerada automaticamente com suporte para todos os 78 endpoints da API
</Card>

**Funcionalidades:**

* Estrutura de comandos baseada em recursos para uso intuitivo
* Vários formatos de saída (JSON, YAML, bonito, interativo)
* Conclusão de shell para bash, zsh e fish
* Perfeito para scripting e automação CI/CD

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

## Migração do SDK Node.js

<Info>
  Migramos do SDK Node.js para o novo SDK TypeScript. Se você está usando o SDK Node.js legada, consulte o [guia de migração](https://github.com/dodopayments/dodopayments-typescript/blob/main/MIGRATION.md) para atualizar sua integração.
</Info>

## Adaptadores de Framework

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

### Frameworks Recomendados

<CardGroup cols={2}>
  <Card title="Next.js" icon="atom" href="/developer-resources/nextjs-adaptor">
    Framework full-stack baseado em React com suporte a App Router
  </Card>

  <Card title="Better Auth" icon="shield" href="/developer-resources/better-auth-adaptor">
    Framework de autenticação com integrações incorporadas
  </Card>

  <Card title="Supabase" icon="database" href="developer-resources/supabase-boilerplate">
    Alternativa de código aberto ao Firebase com Postgres e Auth
  </Card>

  <Card title="Convex" icon="database" href="/developer-resources/convex-component">
    Backend-as-a-Service com capacidades em tempo real
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Show other 8+ supported frameworks">
    <CardGroup cols={4}>
      <Card title="SvelteKit" icon="js" href="/developer-resources/sveltekit-adaptor" />

      <Card title="Nuxt" icon="vuejs" href="/developer-resources/nuxt-adaptor" />

      <Card title="Remix" icon="react" href="/developer-resources/remix-adaptor" />

      <Card title="Express" icon="js" href="/developer-resources/express-adaptor" />

      <Card title="Fastify" icon="bolt" href="/developer-resources/fastify-adaptor" />

      <Card title="Hono" icon="cloud" href="/developer-resources/hono-adaptor" />

      <Card title="Astro" icon="star" href="/developer-resources/astro-adaptor" />

      <Card title="TanStack" icon="chart-line" href="/developer-resources/tanstack-adaptor" />
    </CardGroup>
  </Accordion>
</AccordionGroup>

## Obtendo Ajuda

Precisa de assistência com algum SDK?

* **Discord**: Junte-se ao nosso [servidor da comunidade](https://discord.gg/bYqAp4ayYh) para ajuda em tempo real
* **Email**: Entre em contato pelo [suporte@dodopayments.com](mailto:suporte@dodopayments.com)
* **GitHub**: Abra uma issue no repositório do respectivo SDK
* **Documentação**: Visite nossa [referência de API](/api-reference/introduction)

## Contribuindo

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

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

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