Inicio
Documentação
Recursos
Certificações
Comunidade

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Reembolsar valor parcial - Reembolsar pagamento - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Reembolsar valor parcial

Para reembolsar um valor parcial, ou seja, devolver somente parte do valor pago, é necessário indicar o valor que deve ser devolvido diretamente no body do request. Para isso, envie um POST ao endpoint /v1/advanced_payments/{advanced_payment_id}/refunds com as devidas informações e execute a requisição ou, se preferir, utilize o curl abaixo.

          
curl -X POST \
'https://api.mercadopago.com/v1/advanced_payments/ADVANCED_PAYMENT_ID/refunds' \
  -H 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
        "amount":25
      }'
      

        

Respostas

Ao executar o request para um reembolso parcial, é possível que se retornem diferentes respostas. Abaixo você encontra o detalhe de cada uma delas, bem como as possíveis causas.

Resposta de sucesso

Código de status: 200

          
[
    {
        "id": 1242469925,
        "payment_id": 51617407254,
        "amount": 25,
        "source": {
            "id": 783789745,
            "name": "Test Test",
            "type": "collector"
        },
        "date_created": "2022-11-18T08:48:06.768-04:00",
        "status": "approved"
    }
]


        

Resposta com falha: Bad request

Esta resposta retorna quando um dos parâmetros de solicitação está incorreto ou não foi encontrado. Por exemplo, este erro ocorrerá quando um id inválido for enviado.

Código de status: 400

          
{
   "status": "400",
   "error":  "bad_request",
   "message": "Invalid splitter id.",
   "cause": [
    {
      "code":"400048",
      "message": "Invalid splitter id",
      "data": null
    }
   ]
}


        

Resposta com falha: Not found

Esta é uma resposta comum que é retornada quando nenhum pagamento antecipado criado com o ID fornecido nos parâmetros da solicitação é encontrado.

Código de status: 404

          
{
   "status": "404",
   "error":  "not_found",
   "message": "Advanced payment not found.",
   "cause": [
    {
      "code":"404002",
      "message": "Advanced payment not found",
      "data": null
    }
   ]
}


        

Resposta com falha: Internal error code

É a resposta que indica que ocorreu um erro no servidor durante o processamento da solicitação. Isso significa que a solicitação do cliente não pôde ser concluída devido a um problema interno no servidor.

Código de status: 500

          
{
   "status": "500",
   "error":  "internal_server_error",
   "message": "Invalid splitter id.",
   "cause": [
    {
      "code":"500000",
      "message": "Internal server error",
      "data": null
    }
   ]
}