Validar cupomhttps://api.mercadopago.com/v2/wallet_connect/coupons
Este endpoint possibilita a validação de um cupom do Wallet Connect, retornando o valor do desconto aplicável. Estes cupons destinam-se a conceder descontos em pagamentos realizadas via Wallet Connect.
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
id
Combinação única de letras e números que representa o código do cupom. Por exemplo - BLACKFRIDAY20.string
Response parameters
status
Indica o status do cupom após a validação. Reflete se é "success", "pending", or "invalid".string
description
Uma breve descrição das características do cupom validado. Por exemplo: cupom de desconto de 30% para Black Friday.string
legal_terms
URL que direciona para os termos legais específicos associados à campanha do cupom. Por exemplo - https://www.mercadopago.com.ar/campaigns/terms-and-conditions/123456.string
detail
Este objeto Fornece uma visão detalhada dos pagamentos antecipados de vendedores que têm uma associação prévia a Wallet Connect.object
Erros
400Erro encontrado durante o processo de validação.
400
Bad-Request - coupon_id inválido.
400
Bad-Request - Payer Token inválido.
500Erro resultante de problemas internos do servidor.
500
Erro interno do servidor.
Request
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-H 'x-payer-token: <PAYER_TOKEN>' \
-d '{
"id": "BLACKFRIDAY20"
}'Response
{
"status": "success",
"description": "Cupom de desconto de 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
}
}