# Validate coupon

This endpoint validates a Wallet Connect coupon code and returns the applicable discount information. In case of success, the request will return a response with status 200.

**POST** `/v2/wallet_connect/coupons`

## Request parameters

### Header

- `x-payer-token` (string, required)
  Payer token associated with the buyer who will use the discount.

- `id` (string, optional)
  Unique coupon code entered by the buyer during the purchase flow. For example: BLACKFRIDAY20.

## Response parameters

- `status` (string, optional)
  Coupon status after validation.
Possible enum values:

  - `success`
  The coupon is valid and the discount was applied.

  - `pending`
  The coupon validation is pending.

  - `invalid`
  The coupon is invalid or expired.

- `description` (string, optional)
  Brief description of the coupon's discount. For example: 30% discount coupon for Black Friday.

- `legal_terms` (string, optional)
  URL with the legal terms associated with the coupon campaign.

- `detail` (object, optional)
  Detailed discount information provided by the coupon.

  - `detail.value` (number, optional)
  Discount amount provided by the coupon.

  - `detail.type` (string, optional)
  Indicates whether the discount is percentage-based ("percent") or a fixed amount ("fixed").

  - `detail.cap` (number, optional)
  Maximum discount amount that can be applied using the coupon.

  - `detail.min_payment_amount` (number, optional)
  Minimum payment amount required to qualify for the discount.

  - `detail.max_payment_amount` (number, optional)
  Maximum payment amount to which the discount can still be applied.

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 400 | 400 | Bad Request — Invalid coupon_id. |
| 400 | 400 | Bad Request — Invalid payer token. |
| 500 | internal_error | Some error occurred on our side while attempting to process the request. Please try again later. |

## Request example

### cURL

```bash
curl -X POST \
  'https://api.mercadopago.com/v2/wallet_connect/coupons' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -d '{
  "id": "BLACKFRIDAY20"
  }'
```

## Response example

```json
{
  "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
  }
}
```