Este endpoint valida um código de cupom do Wallet Connect e retorna as informações do desconto aplicável. O cupom validado poderá ser usado em uma promessa de desconto a partir do endpoint de "/v2/wallet_connect/discounts". Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
400Erro de requisição.
invalid_coupon
O ID do cupom é inválido. Por favor, verifique o valor enviado e tente novamente.
invalid_payer_token
O token de pagamento token enviado no header "x-payer-token" é inválido. Por favor, verifique o valor enviado e tente novamente.
500Erro genérico.
internal_error
Ocorreu um erro interno no servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte e forneça o x-request-id e detalhes sobre a operação realizada.
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'x-payer-token: <PAYER_TOKEN>' \
-d '{
"id": "BLACKFRIDAY20"
}'{
"status": "success",
"description": "Cupón de descuento del 30% para Black Friday.",
"legal_terms": "https://www.mercadopago.com.ar/campaigns/terms-and-conditions/123456",
"detail": {
"value": 10,
"type": "percent",
"cap": 100,
"min_payment_amount": 100,
"max_payment_amount": 10000
}
}