Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Create discount promise - Discounts - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Create discount promise

POST

https://api.mercadopago.com/v2/wallet_connect/discounts
This endpoint allows you to create a "discount promise" for Wallet Connect. This "discount promise" serves as a reference that can be used when generating an Advanced Payment, enabling the application of a specific discount to the payment. During the payment creation process, it's essential to include the information from the previously provided "discount promise".
Request's parameters
HEADER
x-payer-token
string

REQUIRED

Token associated to the potential payer who will use the discount. For example - e9449535fe074e0e8ff4f2055f604e51.
BODY
coupon
string
UUnique ID that identifies the coupon for discount application. This field should be filled out only when the user enters a coupon during the purchasing process with the seller.
amount
number

REQUIRED

Total payment amount before aplying discount. For example, 15.05.
Response parameters
transaction_amount
number
Total payment amount before aplying discount. For example, 150.
currency_id
string
Type of currency to be used in payment. For example, ARS for Argentina, BRL for Brazil. This field varies according to your location.
legal_terms
string
Terms and conditions of discount.
discount
object
Discount description.
Errors

400Error

400

Bad-Request - Invalid amount in discount.

400

Bad-Request - Invalid coupon in discount.

400

Bad-Request - Invalid payer token.

500Error

500

Error - Internal server error.

Request
curl -X POST \
    'https://api.mercadopago.com/v2/wallet_connect/discounts'\
    -H 'Content-Type: application/json' \
       -H 'x-payer-token: <PAYER_TOKEN>' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "coupon": "WALLET10",
  "amount": 15.05
}'
Sample answer
{
  "transaction_amount": 150,
  "currency_id": "ARS",
  "legal_terms": "https://api.mercadopago.com/v2/discounts/campaign/10580513/terms/html",
  "discount": {
    "amount": 15,
    "detail": {
      "cap": 1000000,
      "type": "percentage",
      "value": 10
    }
  }
}