Validate Promotion Code

POST

/api/:account_id/promotion-codes/validate

Validate a promotion code without redeeming it.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

account_idstringRequired

This endpoint expects an object.

codestringRequired

The promotion code to redeem

customer_idstring or nullOptional

Customer applying the code (for validation)

order_amountdouble or nullOptional>=0

Order amount for minimum validation

order_currencyenum or nullOptional

Order currency

Successful Response

validboolean

Whether the promotion code is valid

errorstring or nullOptional

Error message if validation failed

promotion_codeobject or nullOptional

The promotion code details if found

422

Unprocessable Entity Error

$	curl -X POST https://app.paymentkit.com/api/account_id/promotion-codes/validate \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"code": "SUMMER2024"
>	}'