Pular para o conteúdo principal

SDKs & Bibliotecas

Acelere sua integração usando SDKs oficiais para TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby e React Native. Essas bibliotecas simplificam as requisições à API, autenticação e tratamento de erros, permitindo que você se concentre em criar ótimas experiências de pagamento.

​
URLs do Ambiente

Saiba mais sobre Modo de Teste vs Modo Ao Vivo.

​
Gerenciamento de Chaves da API e Autenticação

1

Acessar Chaves da API

Navegue até Desenvolvedor → Chaves da API em seu painel para gerenciar suas chaves.
2

Gerar uma Nova Chave

Selecione Adicionar Chave da API, forneça um nome descritivo e configure o acesso de escrita:
  • Habilitar acesso de escrita (marcado): Permissões completas de leitura e escrita para todas as operações da API
  • Habilitar acesso de escrita (desmarcado): Acesso somente leitura - pode apenas buscar dados (pagamentos, assinaturas, clientes, produtos). Não pode criar ou modificar recursos.
Desmarque “Habilitar acesso de escrita” para integrações de painel, ferramentas de análise e qualquer sistema que precise apenas visualizar dados sem fazer alterações.
3

Armazene Sua Chave com Segurança

Copie a chave gerada imediatamente e certifique-se de que ela seja armazenada com segurança.
4

Autentique Suas Requisições à API

Use suas chaves da API para autenticar todas as requisições. Aplique o seguinte formato de autorização:
Authorization: Bearer YOUR_API_KEY
Nunca exponha suas chaves secretas da API em código do lado do cliente ou repositórios públicos.

​
Formato de Resposta

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Limites de Taxa

  • Padrão: 1000 requisições por minuto por empresa
  • Pico: Até 100 requisições por segundo
Monitore o cabeçalho X-RateLimit-Remaining para rastrear o uso.

​
Tratamento de Erros

Para gerenciar erros de forma eficaz, consulte as seções Códigos de Erro e Falhas de Transação para orientações detalhadas.

Códigos de Erro

Aprofunde-se em detalhes abrangentes sobre erros e suas resoluções.

Falhas de Transação

Obtenha insights sobre problemas comuns de transação e suas soluções.

​
Webhooks

Receba notificações em tempo real sobre eventos de pagamento. Veja nosso Guia de Webhooks para instruções de configuração.

Guia de Webhooks

Configure webhooks para notificações em tempo real e tratamento de eventos.