PREVIEW

Pagamentos

Consulta e operação sobre transações PIX e cartão das suas rifas.

GET/v1/payments/:id

Detalhe de pagamento

Retorna o objeto completo do pagamento (PIX ou cartão) com status e timestamps.

GET/v1/payments

Listar pagamentos

Filtros: ?status=paid&method=pix&from=2026-01-01&to=2026-12-31.

POST/v1/payments/:id/refund

Estornar pagamento

Estorna parcial ou totalmente. Só funciona em pagamentos confirmados e dentro do prazo da adquirente.

{
  "valor_centavos": 1000,
  "motivo": "duplicidade"
}

Status possíveis

  • pending: pagamento criado, aguardando confirmação
  • paid: confirmado, repasse efetuado
  • held: em análise antifraude (cartão)
  • failed: recusado ou expirado
  • refunded: estornado total
  • partial_refund: estornado parcialmente