Recursos para IA
Validar cupomhttps://api.mercadopago.com/v2/wallet_connect/coupons
Este endpoint valida um código de cupom do Wallet Connect e retorna as informações do desconto aplicável. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
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 de pagamento associado ao comprador que utilizará o desconto.string
OBRIGATÓRIO
Body
id
Código único do cupom inserido pelo comprador durante o fluxo de compra. Por exemplo: BLACKFRIDAY20.string
Response parameters
status
Status do cupom após a validação.string
success: O cupom é válido e o desconto foi aplicado.
pending: A validação do cupom está pendente.
invalid: O cupom é inválido ou expirou.
description
Breve descrição do desconto do cupom. Por exemplo: cupom de desconto de 30% para Black Friday.string
legal_terms
URL com os termos legais associados à campanha do cupom.string
detail
Informações detalhadas do desconto fornecido pelo cupom.object
Erros
400Erro de requisição.
400
Bad Request — coupon_id inválido.
400
Bad Request — Payer token inválido.
500Erro de processamento.
internal_error
Ocorreu um erro do nosso lado ao tentar processar a requisição. Por favor, tente novamente mais tarde.
Request
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
-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
}
}