Criar reembolso - Reembolsos - Mercado Pago Developers
Criar reembolso

POST

/v1/payments/{id}/refunds
Criar um reembolso parcial/total para um pagamento específico. Se o campo amount estiver preechido, será criado um reembolso parcial, caso contrário, se criará um reembolso total.
Parâmetros de requisição
id

OBRIGATÓRIO

string
Localização: pathIdentificador de pagamento
X-Idempotency-Key
string
Localização: headerIdempotency key. Quando usada, evita reembolsos duplicados
amount
number
Localização: bodyValor do reembolso. Se a propriedade (amount) for removida do body, criará um reembolso integral.
Parâmetros de resposta
id
number
Localização: bodyIdentificador do reembolso
payment_id
number
Localização: bodyIdentificador de pagamento
amount
number
Localização: bodyValor do reembolso
metadata
array
Localização: bodyContém metadados de pagamento que nos são enviados no post de payment
Solicitação
curl
curl -X POST \
    'https://api.mercadopago.com/v1/payments/{id}/refunds' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "amount": 5
}'
Resposta
json
{
  "id": 1009042015,
  "payment_id": 18552260055,
  "amount": 10,
  "metadata": [
    {}
  ],
  "source": [
    {
      "name": "Firstname Lastname",
      "id": "1003743392",
      "type": "collector"
    }
  ],
  "date_created": "2021-11-24T13:58:49.312-04:00",
  "unique_sequence_number": null,
  "refund_mode": "standard",
  "adjustment_amount": 0,
  "status": "approved",
  "reason": null,
  "label": [
    {}
  ],
  "partition_details": [
    {}
  ]
}
Erros
400bad_request
20632063--A-ação-soliciada-não-é-válida-para-o-status-de-pagamento-atual--estão-faltando-informações-no-header-ou-o-pagamento-foi-totalmente-estornado-
401bad_request
401401--Token-inválido--Insira-um-token-válido-
40404040--atributo-valor-deve-ser-positivo--Valor-deve-ser-maior-que-0-
40414041--atributo-valor-deve-ser-numérico--Valor-deve-ser-um-número-
404bad_request
20322032--Estorno-não-encontrado--X-Idempotency-key-já-utilizada-
20002000--Pagamento-não-econtrado--Payment_Id_inexistente-