Skip to main content
Bem-vindo à documentação oficial da FastPay API! Este guia irá ajudá-lo a dar os primeiros passos para integrar nossa solução de pagamentos em sua aplicação.

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:
  1. Credenciais de API
    • API Key de autenticação
    • URL base da API
  2. 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 formato SUA_API_KEY: convertido para base64:
Formato do Token:
  • Combine SUA_API_KEY: (sua chave secreta seguida de dois pontos)
  • Converta para base64
  • Use o resultado no header Authorization
Exemplo:

2. Teste de Conexão

Faça uma requisição simples para verificar se suas credenciais estão funcionando:

  1. 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:

Suporte

Precisa de ajuda? Entre em contato através do nosso site oficial.