API FastPay

Integre o gateway de pagamentos FastPay na sua plataforma de forma rápida, segura e transparente.

Autenticação

Todas as requisições para a API exigem um cabeçalho de autorização contendo sua Chave de API (disponível em Configurações).

Authorization: Bearer sk_live_your_api_key_here

Taxas e Tarifas

O FastPay possui uma estrutura de taxas simplificada para garantir a melhor conversão para o seu negócio.

PIX Recebimento (Venda) R$ 0,75 fixo
PIX Saída (Saque) R$ 0,75 fixo
Mensalidade / Adesão Grátis

Gerar Transação PIX

Cria uma nova cobrança PIX para o seu cliente e retorna o QR Code imediatamente.

POST /api/pay.php

Parâmetros (JSON Body)

Campo	Tipo	Obrigatório	Descrição
`amount`	int	Sim	Valor em centavos (Ex: 10000 para R$ 100,00)
`description`	string	Não	Descrição que aparecerá no extrato do cliente
`customer[name]`	string	Sim	Nome completo do comprador
`customer[document]`	string	Sim	CPF ou CNPJ do comprador

Exemplo de Requisição (cURL)

                    curl -X POST http://localhost:8000/api/pay.php?id=link_123 \
                    -H "Authorization: Bearer sk_live_..." \
                    -H "Content-Type: application/x-www-form-urlencoded" \
                    -d "customer_email=cliente@email.com"
                

Exemplo de Resposta

                    {
                    "id": "txn_89ABCDEF",
                    "status": "PENDENTE",
                    "amount": 5000,
                    "pix_qrcode_url": "https://api.qrserver.com/v1/create-qr-code/...",
                    "pix_copy_paste": "00020101021126360014br.gov.bcb.pix0114...",
                    "created_at": "2026-03-05T14:00:00-03:00"
                    }
                

Consultar Status

Use este endpoint para verificar o estado atual de uma transação ou saque já criado.

GET /api/check_status.php?id=txn_89ABCDEF

                    {
                    "id": "txn_89ABCDEF",
                    "status": "PAGO",
                    "is_paid": true
                    }
                

Solicitar Saque

Solicita um saque a partir do saldo disponível da conta autenticada.

POST /api/withdrawal.php

                    {
                    "amount": 5000,
                    "pix_key": "financeiro@empresa.com",
                    "pix_key_type": "EMAIL"
                    }
                

Webhooks (Em Breve)

O sistema de Webhooks permitirá que seu servidor seja notificado automaticamente assim que um pagamento for confirmado.

Por enquanto, você pode consultar o status das transações via painel administrativo.