Consulte detalhes de qualquer transação (depósito ou saque) pelo internal_id.

Transações

Retorna os detalhes completos de uma transação criada pela sua conta — depósito (PIX in) ou saque (PIX out).

A rota é IDOR-safe: consultar internal_id de outro merchant retorna 404, mesmo que o ID exista. Você só vê suas próprias transações.

GET `/v1/transactions/:id`

Headers

Header	Obrigatório
`client-id`	sim
`client-secret`	sim

Path

Parâmetro	Descrição
`:id`	O `internal_id` retornado quando a transação foi criada

Exemplo

curl https://api.moneyflybr.com/v1/transactions/cl_abc123 \
  -H "client-id: mf_pk_live_..." \
  -H "client-secret: mf_sk_live_..."

Resposta (HTTP 200)

{
  "internal_id": "cl_abc123",
  "external_id": "pedido-12345",
  "type": "deposit",
  "status": "paid",
  "amount": 9990,
  "fee_amount": 198,
  "net_amount": 9792,
  "qrcode": "00020126...",
  "pix_key": null,
  "pix_key_type": null,
  "payer_name": null,
  "utm": "instagram-ads",
  "created_at": "2026-04-24T18:30:00Z",
  "paid_at": "2026-04-24T18:30:42Z",
  "cancelled_at": null,
  "expires_at": "2026-04-24T19:30:00Z"
}

Campo	Descrição
`internal_id`	Nosso ID. Único e imutável
`external_id`	Seu ID interno (se você passou na criação)
`type`	`deposit` ou `payout`
`status`	`pending` · `paid` · `cancelled` · `failed`
`amount`	Valor bruto em centavos
`fee_amount`	Taxa cobrada (centavos)
`net_amount`	Valor líquido (creditado pro merchant em depósitos)
`qrcode`	Em depósitos: copia-e-cola PIX. Em saques: `null`
`pix_key` / `pix_key_type`	Em saques: chave do destinatário. Em depósitos: `null`
`payer_name`	Nome do pagador (se você forneceu na criação do depósito)
`paid_at`	Timestamp da confirmação de pagamento (`null` enquanto pendente)
`cancelled_at`	Timestamp do cancelamento (se houver)
`expires_at`	Timestamp em que o QR/saque expira

Quando consultar

Conferir status sem esperar webhook — útil em fluxos onde o usuário final aguarda confirmação na tela. Mas prefira webhook se possível.
Reconciliação — bater seu sistema interno com nossos dados.
Replay de problema — ver se uma transação realmente existe e em que estado.

Erros

404 — internal_id não existe ou pertence a outro merchant. Resposta intencionalmente igual nos dois casos pra não vazar informação.

{
  "error": "Not Found",
  "message": "Transaction não encontrada."
}

Transações

On this page