Recursos para IA

Reembolsos e cancelamentos

Os reembolsos e os cancelamentos são gestões que você pode realizar uma vez que um pagamento tenha sido efetuado. Por se tratar de ações que implicam uma devolução de dinheiro, podem parecer similares, mas é importante levar em consideração o que as diferencia para poder realizar corretamente cada um dos processos.

Reembolso: é feito após a captura do pagamento e a devolução do valor será feita diretamente na fatura, no caso de cartão de crédito, ou na conta do pagador, quando o pagamento for feito por outros meios.
Cancelamento: é feito quando o pagamento ainda não foi concluído e requer uma ação adicional, e o limite é devolvido ao cartão do comprador dentro do período definido pelo banco emissor.

Veja abaixo mais informações sobre reembolsos e cancelamentos.

Esta documentação é destinada a integradores. Se você é comprador e deseja cancelar ou solicitar o reembolso de um pagamento, acesse sua conta do Mercado Pago, selecione a compra em questão, clique em "Preciso de ajuda" e escolha a opção de reembolso ou cancelamento.

Reembolsos em Split de Pagamentos

São transações realizadas quando determinada cobrança é revertida e os valores pagos retornam aos participantes da transação. Você pode realizar reembolsos a participantes específicos sem afetar a parte dos demais, ou realizar um reembolso total. A seguir, você encontrará as diferentes formas de gerenciar um reembolso.

No Split de Pagamentos 1:N você não pode misturar transactions e splits na mesma solicitação de reembolso. Para orders criadas com split, é necessário usar apenas o objeto splits, indicando, para cada participante que recebe o reembolso, seu User ID e o valor a devolver.

Reembolso total da order

Para reembolsar o valor total a todos os participantes do Split de Pagamentos, envie um POST para Reembolsar uma orderAPI com o body vazio e seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste..

curl
curl --request POST \
  --url https://api.mercadopago.com/v1/orders/{Order_id}/refund \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'

json
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32959",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "amount": "24.50",
        "status": "processed"
      }
    ]
  }
}

Reembolso total de um participante

Para reembolsar o valor total a um único participante, envie um POST para Reembolsar uma orderAPI e especifique apenas o User ID dele.

curl
curl --request POST \
  --url https://api.mercadopago.com/v1/orders/{Order_id}/refund \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
  --data '{
  "splits": [
    {
      "user_id": {{SELLER_1_USER_ID}}
    }
  ]
}'

A tabela a seguir descreve os parâmetros do corpo da requisição.

Parâmetro	Tipo	Descrição
`splits`	Array	Lista de objetos com o reembolso por participante.
`splits.user_id`	Integer	User ID da conta do Mercado Pago do participante que recebe este valor de reembolso.

json
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32959",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "amount": "24.50",
        "status": "processed"
      }
    ]
  }
}

Reembolso parcial de um participante

Para reembolsar um valor específico a um único participante, envie um POST para Reembolsar uma orderAPI com o User ID do participante e o valor específico.

curl
curl --request POST \
  --url https://api.mercadopago.com/v1/orders/{Order_id}/refund \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
  --data '{
  "splits": [
    {
      "user_id": {{SELLER_1_USER_ID}},
      "amount": "50.00"
    }
  ]
}'

A tabela a seguir descreve os parâmetros do corpo da requisição de reembolso parcial.

Parâmetro	Tipo	Descrição
`splits`	Array	Lista de objetos com o reembolso por participante.
`splits.user_id`	Integer	User ID da conta do Mercado Pago do participante que recebe este valor de reembolso.
`splits.amount`	String	Valor a reembolsar a este participante. Montante em dinheiro, não percentual.

json
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32959",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "amount": "50.00",
        "status": "processed"
      }
    ]
  }
}

Reembolso múltiplo

Você pode usar o mesmo padrão do reembolso de um único participante para reembolsar dois ou mais ao mesmo tempo, incluindo mais de um objeto no array splits. Envie um POST para Reembolsar uma orderAPI com o User ID e o valor específico de cada participante.

curl
curl --request POST \
  --url https://api.mercadopago.com/v1/orders/{Order_id}/refund \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
  --data '{
  "splits": [
    {
      "user_id": {{SELLER_1_USER_ID}},
      "amount": "50.00"
    },
    {
      "user_id": {{SELLER_2_USER_ID}},
      "amount": "10.00"
    }
  ]
}'

A tabela a seguir descreve os parâmetros do corpo da requisição de reembolso múltiplo.

Parâmetro	Tipo	Descrição
`splits`	Array	Lista de objetos com o reembolso por participante.
`splits.user_id`	Integer	User ID da conta do Mercado Pago do participante que recebe este valor de reembolso.
`splits.amount`	String	Valor a reembolsar a este participante. Montante em dinheiro, não percentual.

json
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32959",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "amount": "50.00",
        "status": "processed"
      },
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32960",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSD",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF8",
        "amount": "10.00",
        "status": "processed"
      }
    ]
  }
}

Cancelamentos

Os cancelamentos permitem anular uma order antes que o pagamento seja confirmado. Ao cancelar, a cobrança não é efetuada e nenhum valor é debitado do comprador.

Para cancelar uma order com Split de Pagamentos 1:N, envie um POST para :TagComponent com o body vazio. Os cancelamentos somente podem ser realizados se o status de pagamento for action_required, e um pagamento expira automaticamente após 30 dias sem confirmação, com status final de cancelled ou expired.

curl
curl --request POST \
  --url https://api.mercadopago.com/v1/orders/{Order_id}/cancel \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'

json
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "cancelled",
  "status_detail": "by_collector"
}

Adobe Commerce

Mercado Pago in your store

Documentação

Começando agora?

Recursos

Suporte

Parcerias

Comunidade

Reembolsos e cancelamentos

Reembolsos em Split de Pagamentos

Cancelamentos

Navegação

Recursos e Comunidade

Mercado Pago

País e idioma