Crear promesa de descuento con cupón pre-añadido

La promesa de descuento con cupón pre-añadido representa una forma simplificada y eficiente de aplicar descuentos en transacciones. En este sistema, es posible que el vendedor muestre el precio con descuento de un producto específico antes de realizar el pago; es decir, antes del checkout.

La creación de la promesa de descuento con cupón pre-añadido se realiza en dos pasos:

• Validar el cupón antes de realizar el pago
• Añadir el cupón antes de proceder al pago

Para validar un cupón antes de proceder con el pago, es importante enviar los datos de la campaña en la solicitud, que asegura que el cliente pueda aprovechar el beneficio del descuento antes de finalizar la compra.

Para ello, utiliza el curl a continuación e inserta los parámetros de acuerdo con la tabla descriptiva. Esta solicitud verificará la validez del cupón y devolverá información detallada sobre el descuento aplicable, si lo hay.

          
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons' \
--header 'Authorization: <Bearer YOUR_ACCESS_TOKEN>' \
--header 'x-payer-token: <PAYER_TOKEN>' \
--header 'Content-Type: application/json' \
-d '{
    "id": "<COUPON>"
 }'

        

Cuando la validación de un código de cupón es necesaria durante el proceso de checkout, es decir, antes de efectuar el pago, es esencial enviar los datos de la campaña en la solicitud subsiguiente.

Esta etapa implica el envío de esta solicitud al sistema, para aplicar el descuento del cupón a la transacción que está a punto de finalizarse.

Utiliza el curl a continuación para realizar la solicitud y asegúrate de que los parámetros sean completados de acuerdo con la siguiente tabla descriptiva.

          
curl -X POST \
  'https://api.mercadopago.com/v2/wallet_connect/discounts' \
  --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  --header 'x-payer-token: <PAYER_TOKEN>' \
  --header 'Content-Type: application/json' \
  -d '{
      "amount": 550,
      "coupon": "<COUPON>"
  }'


        

Al añadir el cupón antes de proceder al pago, es posible que se reciban diferentes respuestas, sean de éxito o errores. A continuación, se detalla cada una de ellas.

1. Respuesta de éxito al añadir cupón

• Código de estado: no se devuelve ningún código en esta solicitud.
• Descripción: la respuesta trae información referente a la moneda, valor del descuento, términos legales, entre otros, lo que atestigua el éxito de la transacción.
• Cuerpo de la respuesta:

{
  "transaction_amount": 550.0,
  "currency_id": "ARS",
  "discount": {
    "amount": 55.0,
    "detail": {
      "value": 10.0,
      "type": "percent",
      "cap": 1000.0
    },
   "legal_terms":"https://mp.com/legal"
  }
}

1. Descuento inexistente para el usuario

• Código de estado: no se retorna ningún código.
• Descripción: Este error se devuelve para informar que no existe un descuento disponible para el usuario.
• Cuerpo de la respuesta:

{
  "transaction_amount": 550.0,
  "currency_id": "ARS",
  "discount": {}
}

2. Transaction_amount debe ser mayor que 0

• Código de estado: 400 (Bad Request).
• Descripción: Este error se devuelve cuando el campo transaction_amount se llena con un valor de 0. En este caso, es necesario ingresar un valor superior a 0 y realizar una nueva solicitud.
• Cuerpo de la respuesta:

{
  "error": "bad_request",
  "message": "transaction_amount must be greater than 0",
  "status": 400
}

3. Transaction_amount no puede estar vacío

• Código de estado: 400 (Bad Request).
• Descripción: Este error se devuelve cuando el campo transaction_amount se deja en blanco. En este caso, es necesario ingresar un valor superior a 0 y realizar una nueva solicitud.
• Cuerpo de la respuesta:

{
  "error": "bad_request",
  "message": "transaction_amount must not be null.",
  "status": 400
}