Recursos para IA
Validar cupón

Este endpoint valida un código de cupón de Wallet Connect y devuelve la información del descuento aplicable. El cupón validado podrá ser usado en una promesa de descuento a partir del endpoint de "/v2/wallet_connect/discounts". En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

POST

https://api.mercadopago.com/v2/wallet_connect/coupons
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
x-payer-token
string

REQUERIDO

Token de pago asociado al comprador que utilizará el descuento.
Body
id
string
Código único del cupón ingresado por el comprador durante el flujo de compra.
Response parameters
status
string
Estado del cupón después de la validación.
success: El cupón es válido y el descuento fue aplicado.
pending: La validación del cupón está pendiente.
invalid: El cupón es inválido o expiró.
description
string
Breve descripción del descuento del cupón.
legal_terms
string
URL con los términos legales asociados a la campaña del cupón.
detail
object
Información detallada del descuento proporcionado por el cupón.
Errors

400Error de solicitud.

invalid_coupon

El ID del cupón es inválido. Por favor, verifica el valor enviado e inténtalo nuevamente.

invalid_payer_token

El token de pago enviado en el header "x-payer-token" es inválido. Por favor, verifica el valor enviado e inténtalo nuevamente.

500Error genérico.

internal_error

Ocurrió un error interno en el servidor. Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte y proporciona el x-request-id y detalles sobre la operación realizada.

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": "Cupón de descuento del 30% para Black Friday.",
  "legal_terms": "https://www.mercadopago.com.uy/campaigns/terms-and-conditions/123456",
  "detail": {
    "value": 10,
    "type": "percent",
    "cap": 100,
    "min_payment_amount": 100,
    "max_payment_amount": 10000
  }
}