Busca inteligente powered by OpenAI
Validar cupom para Wallet Connect
POST
Produtos relacionados:
Parâmetros de requisição
HEADER
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
Parâmetros de resposta
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.
Requisição
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons'\
-H 'Content-Type: application/json' \
-H 'x-payer-token: <PAYER_TOKEN>' \
-H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
-d '{
"id": "BLACKFRIDAY20"
}'Resposta de exemplo
{
"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
}
}