Inicio
Documentação
Recursos
Certificações
Comunidade

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Validar cupom - Cupons - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Validar cupom para Wallet Connect

POST

https://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.
Parâmetros de requisição
HEADER
x-payer-token
string

OBRIGATÓRIO

Token relacionado ao potencial pagador que utilizará o desconto. Por exemplo - e9449535fe074e0e8ff4f2055f604e51.
BODY
id
string
Combinação única de letras e números que representa o código do cupom. Por exemplo - BLACKFRIDAY20.
Parâmetros de resposta
status
string
Indica o status do cupom após a validação. Reflete se é "success", "pending", or "invalid".
description
string
Uma breve descrição das características do cupom validado. Por exemplo: cupom de desconto de 30% para Black Friday.
legal_terms
string
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.
detail
object
Este objeto Fornece uma visão detalhada dos pagamentos antecipados de vendedores que têm uma associação prévia a Wallet Connect.
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-5599*********291-02171*********139a4791e*********f7f5835-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
  }
}