Recursos para IA
Validar cupónhttps://api.mercadopago.com/v2/wallet_connect/coupons
Este endpoint valida un código de cupón de Wallet Connect y devuelve la información del descuento aplicable. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
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 de pago asociado al comprador que utilizará el descuento.string
REQUERIDO
Body
id
Código único del cupón ingresado por el comprador durante el flujo de compra. Por ejemplo: BLACKFRIDAY20.string
Response parameters
status
Estado del cupón después de la validación.string
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
Breve descripción del descuento del cupón. Por ejemplo: cupón de descuento del 30% para Black Friday.string
legal_terms
URL con los términos legales asociados a la campaña del cupón.string
detail
Información detallada del descuento proporcionado por el cupón.object
Errores
400Error de solicitud.
400
Bad Request — coupon_id inválido.
400
Bad Request — Payer token inválido.
500Error de procesamiento.
internal_error
Ocurrió un error de nuestra parte al intentar procesar la solicitud. Por favor, inténtalo nuevamente más tarde.
Request
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-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
}
}