Recursos para IA

Reembolsos y cancelaciones

Los reembolsos y las cancelaciones son gestiones que puedes realizar una vez que un pago haya sido efectuado. Por tratarse de acciones que implican una devolución del dinero, pueden resultar similares, pero es importante tener en cuenta qué las diferencia para poder realizar correctamente cada uno de los procesos.

Reembolso: se realiza después de la captura del pago, y la devolución del monto se hace directamente en la factura, en el caso de una tarjeta de crédito, o en la cuenta del pagador, cuando el pago se haya realizado por otros medios.
Cancelación: se realiza cuando el pago aún no fue completado y requiere una acción adicional, y el dinero es devuelto a la tarjeta del comprador dentro del período definido por el banco emisor.

Accede a continuación a más información sobre reembolsos y cancelaciones.

Esta documentación está destinada a integradores. Si eres comprador y necesitas cancelar o solicitar el reembolso de un pago, ingresa a tu cuenta de Mercado Pago, selecciona la compra para la que quieres solicitarlo, haz clic en "Necesito ayuda" y elige la opción de reembolso o cancelación.

Reembolsos en Split de Pagos

Son transacciones que se realizan cuando un cargo determinado es revertido y los montos pagados regresan a los participantes de la transacción. Puedes realizar reembolsos a participantes específicos sin afectar el cobro de los demás, o bien realizar un reembolso completo. A continuación, encontrarás las diferentes maneras de gestionar un reembolso.

En Split de Pagos 1:N no puedes mezclar transactions y splits en la misma solicitud de reembolso. Para orders creadas con split, debes usar únicamente el objeto splits indicando, por cada participante que recibe el reembolso, su User ID y el monto a devolver.

Reembolso total de la order

Para reembolsar el monto total a todos los participantes del Split de Pago, envía un POST a Reembolsar una orderAPI con el body vacío y tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba..

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 para un participante

Para reembolsar el monto total a un solo participante, envía un POST a Reembolsar una orderAPI y especifica únicamente su User ID.

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}}
    }
  ]
}'

La siguiente tabla describe los parámetros del cuerpo de la solicitud.

Parámetro	Tipo	Descripción
`splits`	Array	Lista de objetos con el reembolso por participante.
`splits.user_id`	Integer	User ID de la cuenta de Mercado Pago del participante que recibe este monto 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 un participante

Para reembolsar un monto específico a un único participante, envía un POST a Reembolsar una orderAPI con el User ID del participante y el monto 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"
    }
  ]
}'

La siguiente tabla describe los parámetros del cuerpo de la solicitud de reembolso parcial.

Parámetro	Tipo	Descripción
`splits`	Array	Lista de objetos con el reembolso por participante.
`splits.user_id`	Integer	User ID de la cuenta de Mercado Pago del participante que recibe este monto de reembolso.
`splits.amount`	String	Monto a reembolsar a este participante. Valor en dinero, no porcentaje.

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últiple

Puedes usar el mismo patrón que el reembolso de un único participante para reembolsar a dos o más al mismo tiempo, incluyendo más de un objeto en el array splits. Envía un POST a Reembolsar una orderAPI con el User ID y el monto 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"
    }
  ]
}'

La siguiente tabla describe los parámetros del cuerpo de la solicitud de reembolso múltiple.

Parámetro	Tipo	Descripción
`splits`	Array	Lista de objetos con el reembolso por participante.
`splits.user_id`	Integer	User ID de la cuenta de Mercado Pago del participante que recibe este monto de reembolso.
`splits.amount`	String	Monto a reembolsar a este participante. Valor en dinero, no porcentaje.

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"
      }
    ]
  }
}

Cancelaciones

Las cancelaciones te permiten anular una order antes de que el pago sea confirmado. Al cancelarla, el cargo no se efectúa y ningún monto es debitado del comprador.

Para cancelar una order con Split de Pagos 1:N, envía un POST a :TagComponent con el body vacío. Las cancelaciones solo se pueden realizar si el estado de pago es action_required, y un pago expira automáticamente después de 30 días sin confirmación, con un estado final de cancelled o 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

Documentación

¿Comenzando ahora?

Recursos

Soporte

Partners

Comunidad

Reembolsos y cancelaciones

Reembolsos en Split de Pagos

Cancelaciones

Navegación

Recursos y Comunidad

Mercado Pago

País e idioma