Responder MED

Manda a defesa de um pedido de MED, com as provas, num pedido só.

POST /v1/meds/{id}/respond

cURL

curl -X POST https://bukio-backend-production.up.railway.app/v1/meds/MED-5Q2W8M4Z3F7K/respond \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "defense": "Venda do pedido 1052 entregue em 10/11/2026 às 14:20 no e-mail do comprador, que abriu o produto em seguida.",
    "evidence": [
      { "fileName": "comprovante-entrega.pdf", "contentBase64": "JVBERi0xLjQK..." }
    ]
  }'

200

{
  "id": "MED-5Q2W8M4Z3F7K",
  "status": "open",
  "statusTitle": "Aberto",
  "amount": 15000,
  "blocked": 15000,
  "deadline": "2026-11-17T15:04:11.000Z",
  "answered": "user",
  "attachments": [
    { "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9", "name": "comprovante-entrega.pdf", "contentType": "application/pdf", "size": 182334 }
  ],
  "defenseAt": "2026-11-11T05:10:00.000Z"
}

Permissão da chave: /meds/respond. Manda a defesa (o que aconteceu na venda e na entrega) e até 5 provas. A WyzeCash leva a defesa e as provas ao banco de quem pagou, que decide.

As provas não voltam para baixar: depois de enviadas, ficam guardadas com a WyzeCash e só vão para o banco de quem pagou. A consulta do MED mostra só o nome e o tamanho de cada uma.

• Só com o MED aberto (status: open) e dentro do prazo (deadline). Uma resposta por MED.
• Com a defesa automática ligada (em MED e disputas, no painel), a WyzeCash pode responder antes de você. Aí este pedido volta 409 MED_NOT_OPEN.
• Pedido maior que o normal da API: até 50 MB, por causa das provas.

id · string · required

MED- + 12 caracteres.

defense · string · required

A defesa, de 20 a 4.000 caracteres: o que foi vendido, quando e como foi entregue, e o que mostra que quem pagou recebeu.

evidence · object[]

Até 5 provas.

Show cada prova

contentBase64 · string · required

O arquivo em base64: imagem JPG, PNG ou WEBP, ou PDF, até 5 MB. O tipo é lido do conteúdo. Aceita o prefixo data:...;base64,.

fileName · string

Nome do arquivo (até 120 caracteres). Sem ele, vira prova-1, prova-2…

​

Resposta

O MED, como em Consultar pedido de MED, já com answered: "user" e as provas em attachments (nome, tipo e tamanho).

​

Erros

HTTP	Código	Quando
409	MED_NOT_OPEN	o MED já foi respondido, está em análise ou foi decidido
409	MED_DEADLINE_PASSED	o prazo acabou
422	DEFENSE_TOO_SHORT	defesa com menos de 20 caracteres
422	INVALID_EVIDENCE	uma prova não está em base64
415	UNSUPPORTED_FILE	uma prova não é imagem nem PDF
413	FILE_TOO_LARGE	uma prova passa de 5 MB
422	TOO_MANY_ATTACHMENTS	mais de 5 provas

cURL

curl -X POST https://bukio-backend-production.up.railway.app/v1/meds/MED-5Q2W8M4Z3F7K/respond \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "defense": "Venda do pedido 1052 entregue em 10/11/2026 às 14:20 no e-mail do comprador, que abriu o produto em seguida.",
    "evidence": [
      { "fileName": "comprovante-entrega.pdf", "contentBase64": "JVBERi0xLjQK..." }
    ]
  }'

200

{
  "id": "MED-5Q2W8M4Z3F7K",
  "status": "open",
  "statusTitle": "Aberto",
  "amount": 15000,
  "blocked": 15000,
  "deadline": "2026-11-17T15:04:11.000Z",
  "answered": "user",
  "attachments": [
    { "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9", "name": "comprovante-entrega.pdf", "contentType": "application/pdf", "size": 182334 }
  ],
  "defenseAt": "2026-11-11T05:10:00.000Z"
}