---
title: "POST /payment-api/v1/bin-promo-code-rules/validate"
method: POST
path: "/payment-api/v1/bin-promo-code-rules/validate"
tags: ["Bin Promo Code Rules"]
---

# POST /payment-api/v1/bin-promo-code-rules/validate

`POST /payment-api/v1/bin-promo-code-rules/validate`

## Request body

- ValidateBinPromoCodeRequest
  - `merchantId` integer, nullable
  - `promoCode` string, nullable
  - `bin` string, nullable

## Response `200`

Success

- ValidateBinPromoCodeResponse
  - `isValid` boolean
  - `brand` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25
  - `brandProductCode` string, nullable
  - `description` string, nullable
  - `iin` string, nullable
  - `bin6Digits` string, nullable
  - `issuer` string, nullable
  - `isVcc` boolean
  - `cardType` 1 | 2 | 3 | 4
  - `country` string, nullable
  - `cardCurrency` string, nullable
  - `checkInDateFrom` string, date-time, nullable
  - `checkInDateTo` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `500` — Server Error

---

[API](https://skmtc.dev/iolpay/apis/iolpay-payment-api-public.md) · [All operations](https://skmtc.dev/iolpay/apis/iolpay-payment-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/iolpay/iolpay-payment-api-public/revisions/f14fdc43700a/schema)
