Inicio
Documentación
Recursos
Partners
Comunidad

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Validar cupón - Cupones - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Validar cúpon para Wallet Connect

POST

https://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.
Parámetros para la solicitud
HEADER
x-payer-token
string

REQUERIDO

Token relacionado con el posible pagador que espera utilizar el descuento. Por ejemplo - e9449535fe074e0e8ff4f2055f604e51.
BODY
id
string
Combinación única de letras y números que representa el código del cupón. Por ejemplo - BLACKFRIDAY20.
Parámetros de respuesta
status
string
Indica el estado del cupón después de la validación. Refleja si es "success", "pending", or "invalid".
description
string
Una breve descripción de las características del cupón validado. Por ejemplo: cupón de descuento del 30% para Black Friday.
legal_terms
string
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.
detail
object
Este objeto proporciona una visión detallada de los pagos anticipados de los vendedores que tienen una asociación previa de Wallet Connect.
Errores

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.

Solicitud
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-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    -d '{
  "id": "BLACKFRIDAY20"
}'
Respuesta de ejemplo
{
  "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
  }
}