Consultar pedido de MED

Um pedido de devolução: valor, quanto está bloqueado, prazo, defesa e decisão.

GET /v1/meds/{id}

cURL

curl https://bukio-backend-production.up.railway.app/v1/meds/MED-5Q2W8M4Z3F7K \
  -H "Authorization: Bearer bk_live_..."

200

{
  "id": "MED-5Q2W8M4Z3F7K",
  "original": { "id": "BKY-7KQ2M9XP4RZT", "payerName": "Ana Souza", "institution": "Banco Exemplo" },
  "status": "rejected",
  "statusTitle": "Contestado",
  "amount": 15000,
  "blocked": 0,
  "owed": 0,
  "fee": 50,
  "receivedFee": 100,
  "receivedFeeOwed": 0,
  "reason": "fraud",
  "reasonTitle": "Fraude",
  "description": "Pagador alega não reconhecer a compra.",
  "deadline": "2026-10-15T15:04:11.000Z",
  "defense": "Pedido 1842 entregue em 09/10 com assinatura do destinatário.",
  "attachments": [ { "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9", "name": "comprovante-entrega.pdf", "type": "application/pdf", "size": 182334 } ],
  "decisionNote": null,
  "defenseAt": "2026-10-09T10:00:00.000Z",
  "decidedAt": "2026-10-12T16:30:00.000Z",
  "createdAt": "2026-10-08T15:04:11.000Z"
}

Escopo transactions:read. De outra conta: 404 NOT_FOUND.

id · string · required

MED- + 12 caracteres.

​

Resposta

id · string

MED- + 12.

original · object | null

O Pix recebido em disputa.

Show propriedades

id · string

BKY- da cobrança.

payerName · string | null

Quem pagou.

institution · string | null

Banco de quem pagou.

status · string

open, analysis, refunded ou rejected.

statusTitle · string

Aberto, Em análise, Devolvido ou Contestado (você ganhou).

amount · integer

Valor pedido.

blocked · integer

Quanto está bloqueado agora (pode ser menor que amount se o saldo não cobria tudo).

owed · integer

Devolvido sem saldo suficiente: o que ainda falta e sai dos próximos recebimentos.

fee · integer

Contestado: tarifa descontada ao liberar o bloqueio.

receivedFee · integer

Taxa de MED recebido, cobrada quando o pedido chegou.

receivedFeeOwed · integer

Quanto dessa taxa ainda falta pagar.

reason · string

fraud, scam ou operational.

reasonTitle · string

Fraude, Golpe ou Falha operacional.

description · string | null

O que o banco de quem pagou alegou.

deadline · string

Prazo para enviar a defesa.

defense · string | null

A defesa enviada no painel.

attachments · object[]

Provas anexadas à defesa (id, nome, tipo, tamanho). O arquivo não se baixa pela API: fica guardado com a WyzeCash. Para responder com as provas, use Responder MED.

decisionNote · string | null

Motivo da decisão, quando houver.

defenseAt · string | null

Quando a defesa foi enviada.

decidedAt · string | null

Quando foi decidido.

createdAt · string

Quando o pedido chegou.

cURL

curl https://bukio-backend-production.up.railway.app/v1/meds/MED-5Q2W8M4Z3F7K \
  -H "Authorization: Bearer bk_live_..."

200

{
  "id": "MED-5Q2W8M4Z3F7K",
  "original": { "id": "BKY-7KQ2M9XP4RZT", "payerName": "Ana Souza", "institution": "Banco Exemplo" },
  "status": "rejected",
  "statusTitle": "Contestado",
  "amount": 15000,
  "blocked": 0,
  "owed": 0,
  "fee": 50,
  "receivedFee": 100,
  "receivedFeeOwed": 0,
  "reason": "fraud",
  "reasonTitle": "Fraude",
  "description": "Pagador alega não reconhecer a compra.",
  "deadline": "2026-10-15T15:04:11.000Z",
  "defense": "Pedido 1842 entregue em 09/10 com assinatura do destinatário.",
  "attachments": [ { "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9", "name": "comprovante-entrega.pdf", "type": "application/pdf", "size": 182334 } ],
  "decisionNote": null,
  "defenseAt": "2026-10-09T10:00:00.000Z",
  "decidedAt": "2026-10-12T16:30:00.000Z",
  "createdAt": "2026-10-08T15:04:11.000Z"
}