Solicitar reembolso

POST/api/v1/orders/:id/refund

Cria uma solicitação de reembolso para um pedido pago.

Escopo necessário: refunds:create

O reembolso não é processado imediatamente. Uma solicitação é criada e analisada pelo admin da plataforma.

Body

reasonstringobrigatório

Motivo do reembolso (mín. 1 caractere, máx. 500)

Exemplo

Requisição

curl -X POST https://app.paysclub.com/api/v1/orders/ORDER_ID/refund \
  -H "Authorization: Bearer pk_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Cliente solicitou cancelamento"}'

201 Created

{
  "data": {
    "id": "...",
    "status": "pending",
    "created_at": "2026-03-15T10:30:00Z"
  }
}

Erros possíveis

400

{ "error": "Order is not paid" }

409

{ "error": "Refund already requested" }