EcomDocs
POSTDevoluções & Disputas

Estornar devolução

Estorna o pagamento da devolução (total ou parcial via amountCents) e notifica o cliente.

POST/returns/{id}/refund
AutenticaçãoPainel admin

Cookie de sessão do painel (ecom_token) + permissão RBAC.

Parâmetros de caminho

  • iduuidobrigatório

    Identificador da devolução.

Corpo da requisição

  • amountCentsintegeropcional

    Valor a estornar (default: total).

Cabeçalhos

  • Cookiestringobrigatório

    Cookie de sessão do painel: ecom_token=<jwt> (obtido em POST /auth/login).

Requisição

curl -X POST "https://api.ecomplataforma.com.br/returns/r_1/refund" \
  -b cookies.txt -H "Content-Type: application/json" \
  -d '{"amountCents":7990}'

Resposta200

200 OK
{ "success": true, "data": { "id": "r_1", "status": "estornado" } }

Respostas de erro

401Não autenticado
401 Não autenticado
{
  "success": false,
  "error": "Sessão ausente ou expirada."
}
403Sem permissão
403 Sem permissão
{
  "success": false,
  "error": "Você não tem permissão para acessar este recurso."
}
404Não encontrado
404 Não encontrado
{
  "success": false,
  "error": "Recurso não encontrado."
}
422Falha de validação
422 Falha de validação
{
  "success": false,
  "error": "O campo 'email' é obrigatório."
}
AnteriorAprovar devoluçãoPróximoListar disputas