Criar promessa de descontohttps://api.mercadopago.com/v2/wallet_connect/discounts
Este endpoint permite criar uma "promesa de descuento" para o Wallet Connect. Essa "promesa de descuento" é uma referência que será usada ao gerar um Advanced Payment, possibilitando aplicar um desconto específico ao pagamento. Durante a criação do pagamento, é essencial incluir as informações da "promesa de descuento" fornecida anteriormente.
POST
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
x-payer-token
Token relacionado ao potencial pagador que utilizará o desconto. Por exemplo - e9449535fe074e0e8ff4f2055f604e51.string
OBRIGATÓRIO
Body
coupon
ID único que identifica o cupom para aplicação do desconto. Este campo deve ser preenchido somente quando o usuário inserir um cupom durante o processo de compra junto ao vendedor.string
amount
Valor total do pagamento antes da aplicação do desconto. Por exemplo, 15.05.number
OBRIGATÓRIO
Response parameters
transaction_amount
Valor total do pagamento antes da aplicação do desconto. Por exemplo, 150.number
currency_id
Tipo de moeda a ser utilizada no pagamento.string
legal_terms
Termos e condições do desconto.string
discount
Descrição do desconto.object
Erros
400Erro
400
Bad-Request - Valor de desconto inválido.
400
Bad-Request - Cupom de desconto inválido.
400
Bad-Request - Payer token inválido.
500Erro
500
Erro - Erro interno do servidor.
Request
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/discounts'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-H 'x-payer-token: <PAYER_TOKEN>' \
-d '{
"coupon": "WALLET10",
"amount": 50
}'Response
{
"transaction_amount": "25",
"currency_id": "CLP",
"legal_terms": "https://api.mercadopago.com/v2/discounts/campaign/10580513/terms/html",
"discount": {
"amount": "25",
"detail": {
"cap": 1000000,
"type": "percentage",
"value": 10
}
}
}