Validar cúpon para Wallet Connecthttps://api.mercadopago.com/v2/wallet_connect/coupons
Este endpoint permite la validación de un cupón de Wallet Connect, devolviendo el monto de descuento aplicable. Estos cupones están diseñados para ofrecer descuentos en pagos realizados a través de Wallet Connect
POST
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
x-payer-token
Token relacionado con el posible pagador que espera utilizar el descuento. Por ejemplo - e9449535fe074e0e8ff4f2055f604e51.string
REQUERIDO
Body
id
Combinación única de letras y números que representa el código del cupón. Por ejemplo - BLACKFRIDAY20.string
Response parameters
status
Indica el estado del cupón después de la validación. Refleja si es "success", "pending", or "invalid".string
description
Una breve descripción de las caracterÃsticas del cupón validado. Por ejemplo: cupón de descuento del 30% para Black Friday.string
legal_terms
Una URL que dirige a los términos legales especÃficos asociados con la campaña del cupón. Por ejemplo - https://www.mercadopago.com.ar/campaigns/terms-and-conditions/123456.string
detail
Este objeto proporciona una visión detallada de los pagos anticipados de los vendedores que tienen una asociación previa de Wallet Connect.object
Errors
400Error encontrado durante el proceso de validación.
400
Bad-Request - coupon_id inválido.
400
Bad-Request - Payer Token inválido.
500Erro resultante de problemas internos do servidor.
500
Error interno del 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
}
}