POST/api/v1/orders/{id}/refund

Reembolsar Pedido

Inicia o reembolso de um pedido aprovado. Repassa para a Pagar.me e reverte comissões de afiliados se houver.

Escopowrite + orders

Parâmetros de caminho

Parâmetro	Tipo	Descrição
id required	uuid	ID do pedido a reembolsar.

bash

curl -X POST https://devexpay-v3.vercel.app/api/v1/orders/9f1c0e8c-.../refund \
  -H "Authorization: Bearer $TOKEN"

json

{
  "id": "9f1c0e8c-...",
  "status": "refund_requested"
}

Parâmetro	Tipo	Descrição
id	uuid	ID do pedido reembolsado.
status	string	Sempre 'refund_requested' — o reembolso pode levar até 30 dias na bandeira.

Status	Descrição
400	Pedido não está com status 'paid'.
401	Token inválido ou ausente.
403	Chave sem escopo write + orders.
404	Pedido não encontrado.