playbook-pricing

Validate Promo Code

Buyer-side validation for the purchase modal (FR-12).

Returns valid=true + the discount math when usable; otherwise returns valid=false + a human-readable reason (without leaking which check failed beyond what the buyer already knows).

post/api/v1/playbooks/{playbook_id}/promo-codes/validate

Request

  • Base URL: https://api.badgeia.com
  • URL: https://api.badgeia.com/api/v1/playbooks/{playbook_id}/promo-codes/validate
  • Auth: none declared

Path parameters

playbook_idstring uuid required

Request body

codestring required

Response

Successful Response

validboolean required
codestring nullable
discount_typestring nullable
discount_valueinteger nullable
discounted_price_centsinteger nullable
list_price_centsinteger nullable
reasonstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.