Pular para o conteúdo principal

API — Pagamento (público)

Rotas sem JWT, usadas pelo fluxo do cliente na página de pagamento ou por integrações que expõem o mesmo contrato.

GET /pay/tx-request/{reference}​

Obtém a transação Solana (ou fluxo equivalente) para a carteira do pagador assinar.

Query obrigatória (Solana): account=<pubkey_do_pagador>

curl -s "{{BASE_URL}}/pay/tx-request/REFERENCE?account=PUBKEY_CARTEIRA_PAGADOR"

Resposta inclui transação serializada (ex.: base64) e dados para assinatura na wallet.

POST /pay/{reference}/submit-tx​

Registra o txId após o envio à rede (fluxo público da pay page).

Body​

{
  "txId": "assinatura_solana_ou_hash"
}

cURL​

curl -s -X POST "{{BASE_URL}}/pay/REFERENCE/submit-tx" \
  -H "Content-Type: application/json" \
  -d '{"txId":"TX_ID"}'

GET /pay/{reference}/info (e rotas relacionadas)​

Dados da ordem exibidos na página de pagamento (status, valores, QR, etc.). Consulte openapi.yaml para o schema exato e campos por rede.

curl -s "{{BASE_URL}}/pay/REFERENCE/info"

Em muitos deploys o frontend Next faz rewrite de /pay para a API: em testes diretos use a mesma base URL da API ({{BASE_URL}}), não apenas o host do site.