Visão Geral
Nossa API oferece uma solução completa para:- Processamento de Pagamentos: Métodos de pagamento locais em múltiplos países
- Assinaturas Recorrentes: Cobrança automática para planos de assinatura
- Gestão de Transações: Controle completo sobre suas transações
- Sistema de Webhooks: Notificações em tempo real sobre mudanças de status
- Gestão de Carteiras: Consulta de saldos e movimentações
- Cobertura Global: Métodos de pagamento específicos por região
- Segurança 3D Secure: Autenticação avançada para transações com cartão de crédito
Pré-requisitos
Antes de começar, certifique-se de ter:- Credenciais de API
- API Key de autenticação
- URL base da API
- Ambiente de Desenvolvimento
- Cliente HTTP (Postman, Insomnia, ou biblioteca de sua linguagem)
- Ambiente para receber webhooks (opcional para testes iniciais)
Primeiros Passos
1. Autenticação
Todas as requisições à API devem incluir o header de autenticação. A API key deve estar no formatoSUA_API_KEY: convertido para base64:
- Combine
SUA_API_KEY:(sua chave secreta seguida de dois pontos) - Converta para base64
- Use o resultado no header Authorization
2. Teste de Conexão
Faça uma requisição simples para verificar se suas credenciais estão funcionando:
- Sua Primeira Transação
Exemplo de criação de uma cobrança com método de pagamento local:
Este exemplo mostra um pagamento PIX (Brasil). A API suporta múltiplos métodos de pagamento locais incluindo Rapipago (Argentina), Khipu (Chile), QRCode e cartões de crédito. Use o endpoint
/v1/payment-methods para consultar os métodos disponíveis por país.Ambientes
A FastPay usa a mesma URL base para sandbox e produção — muda apenas a chave de API utilizada.
Para gerar a chave de teste: no painel da FastPay logado, abra o menu no canto superior direito (onde ficam seu nome e e-mail) e ative o Modo Teste. Lá ficam todas as movimentações de teste e é onde você gera a chave de API de teste. Mais detalhes em Autenticação.
Próximos Passos
Agora que você está familiarizado com os conceitos básicos, explore:- Autenticação - Detalhes completos sobre autenticação
- Assinaturas Recorrentes - Cobrança automática para planos de assinatura
- 3D Secure SDK - Implementação de autenticação 3DS para cartões
- Webhooks - Sistema de notificações em tempo real
- Referência da API - Documentação completa de todos os endpoints