Guia de Início Rápido

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
• 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:

Authorization: Basic <token_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:

# Se sua API key for: abc123
# O formato será: abc123:
# Convertido para base64: YWJjMTIzOg==
# Header final: Authorization: Basic YWJjMTIzOg==

2. Teste de Conexão

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

curl -X GET "https://api-global.fastpaybrasil.com/v1/payment-methods" \
  -H "Authorization: Basic <seu_token_base64_aqui>"

3. Sua Primeira Transação

Exemplo de criação de uma cobrança com método de pagamento local:

curl -X POST "https://api-global.fastpaybrasil.com/v1/charges" \
  -H "Authorization: Basic <seu_token_base64_aqui>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "BRL",
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com",
      "document": {
        "type": "cpf",
        "id": "12345678900"
      },
      "phone": "11987654321",
      "address": {
        "country": "BRA"
      }
    },
    "paymentMethod": {
      "type": "pix",
      "expirationInDays": 1
    },
    "items": [
      {
        "title": "Produto XYZ",
        "type": "digital",
        "description": "Descrição do produto",
        "unit_price": 100,
        "quantity": 1
      }
    ],
    "postbackUrl": "https://meusite.com/webhook/pagamentos"
  }'

Nota: 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

Ambiente	URL Base	Descrição
Produção	https://api-global.fastpaybrasil.com	Ambiente de produção com transações reais

Próximos Passos

Agora que você está familiarizado com os conceitos básicos, explore:

• Autenticação - Detalhes completos sobre autenticação
• 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

Suporte

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

---