Validate a coupon code - Hasta Backend

Request: application/json

Preview-only - checks a coupon code against eligibility rules (active window, early-registration cutoff, first-purchase-only, plan restriction, per-user/global redemption caps) for the given plan and returns the discounted price. Writes nothing.

Body: code, subscription_slug

Success: 200 - valid true/false with a reason string when false ("Invalid coupon code", "Invalid subscription plan" for a bad subscription_slug, or an eligibility reason) plus original_price/discount_amount/final_price (all 0 when the plan itself wasn't found, since there's no price to compute against)

Errors: 401 - not authenticated. A bad subscription_slug or code is NEVER a 404/422 here - always a 200 with valid: false, since this is a preview endpoint, not a mutation.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "code": "FIRSTPLAN20",
    "subscription_slug": "sage-monthly"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "valid": true,
        "original_price": 299,
        "discount_amount": 59.8,
        "final_price": 239.2
    }
}

🟠401Unauthorized

🟠406Record Not Found

🟠422Parameter Error

🟠429Parameter Error