Create discount promise with pre-added coupon

The discount promise with pre-added coupon represents a simplified and efficient way to apply discounts on transactions. In this system, the seller can display the discounted price of a specific product before payment is made, that is, before checkout.

Creating a discount promise with a pre-added coupon is done in two steps:

• Validate the coupon before payment
• Add the coupon before proceeding to payment

To validate a coupon before proceeding with payment, it is important to send campaign data in the subsequent request. This request ensures that the customer can take advantage of the discount benefit before finalizing the purchase.

For this, use the curl below and insert the parameters according to the descriptive table. This request will verify the validity of the coupon and return detailed information about the applicable discount, if any.

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

        

When the validation of a coupon code is necessary during checkout, that is, before making a payment, it is essential to send the campaign data in the subsequent request.

This step involves sending a request to the system to apply the coupon discount to the transaction that is about to be finalized.

Use the curl below to make the request and ensure that the parameters are filled in according to the following descriptive table.

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


        

When adding the coupon before proceeding to payment, different responses can be received (success/error). Below is a detailed explanation of each of these responses.

1. Successful response when adding coupon

• Status code: no code is returned in this request.
• Description: the response brings information related to the currency, discount value, legal terms, among others, which attests to the success of the transaction.
• Response body:

{
  "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. Non-existent discount for user

• Status code: no code is returned.
• Description: This error returns to inform that there is no discount available for the user.
• Response body:

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

2. Transaction_amount must be greater than 0

• Status Code: 400 (Bad Request).
• Description: This error returns when the transaction_amount field is filled with a value of 0. In this case, it is necessary to enter a value greater than 0 and make a new request.
• Response Body:

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

3. Transaction_amount must not be null

• Status code: 400 (Bad Request).
• Description: this error returns when the transaction_amount field is left blank. In this case, it is necessary to enter a value greater than 0 and make a new request.
• Response body:

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