⚡ QuickPay (Pix In)

Funcionalidade ágil para recebimentos instantâneos via Pix. O sistema utiliza integração direta com parceiros bancários para garantir liquidação imediata e notificação de pagamento.

---

📥 1. Pix In (Recebimento)

Endpoints para geração de QR Codes e monitoramento de entradas de dinheiro na sua conta FnWallet.

Criar QR Code Dinâmico

POST /quickpay/pix/create

Gera uma cobrança Pix dinâmica para um pagamento único.

Request Body:

Campo	Tipo	Obrigatório	Descrição
amount	numeric	✅	Valor do Pix (Formatado como float: 15.50).
description	string		Texto opcional que aparecerá no extrato do pagador.
webhook	url		URL opcional para receber notificação POST ao pagar.
name	string		Nome do cliente pagador.
document	string		CPF/CNPJ do cliente pagador.
expiration_date	date		Prazo de expiração (Default: 5 dias).

Exemplo de Resposta (201 Created)

{
  "success": true,
  "data": {
    "pix": {
      "txid": "TX123456789",
      "value": 15.50,
      "qrcode": "00020101021226840014...",
      "created_at": "2024-03-21T10:00:00Z"
    }
  }
}

DICA

Para listar todos os recebimentos recentes, utilize GET /quickpay/pix/list com suporte a paginação via page e per_page.

---

Consultar Pix Específico

GET /quickpay/pix/{txid}

Retorna o status atual da transação Pix e metadados.

Status Possíveis:

• PENDING: Aguardando pagamento.
• PAID: Liquidação confirmada.
• EXPIRED: Tempo de validade excedido.