Verify License (SaaS)

Endpoint to verify a SaaS subscription license by providing the license code and product ID.

Request Example

curl --request POST 'https://api.mayar.id/saas/v2/license/verify' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here' \
--header 'Content-Type: application/json' \
--data-raw '{
    "licenseCode": "YOUR-LICENSE-CODE",
    "productId": "YOUR-PRODUCT-ID"
}'

Response Example 200

{
    "statusCode": 200,
    "isLicenseActive": true,
    "memberStatus": "ACTIVE",
    "licenseCode": {
        "licenseCode": "CA5DA5D3E1AA8B74",
        "status": "ACTIVE",
        "expiredAt": "2026-04-22T17:12:53.646Z",
        "transactionId": "994d4071-a81e-4558-a854-47530eea9b6d",
        "productId": "84d1d247-a8b3-4c7d-96f0-cf276edb7c33",
        "customerId": "6a38cf26-6bab-42c8-92be-72f3a9fd4c33",
        "customerName": "John Doe",
        "customerEmail": "[e-mail]",
        "createdAt": "2024-02-12T08:41:13.579Z",
        "updatedAt": "2024-02-12T08:57:36.047Z",
        "membershipTierId": "c96850f9-b379-4ed3-bcf2-6d88a87bd20c",
        "membershipTierName": "Master Black Belt Membership",
        "memberPaymentLink": "https://johndoe.mayar.id/pay-membership/MBR8X2QK"
    }
}

Endpoint:

Production

https://api.mayar.id/saas/v2/license/verify

https://api.mayar.club/saas/v2/license/verify

Authorization

Authorization · string · required

Example:

Authorization | Bearer Paste-Your-API-Key-Here

Request Body

licenseCode · string · required

The SaaS license code to verify.

productId · string · required

The ID of the product (payment link) associated with the license.

Response

Successful Response

Main Structure (Root)

statusCode · integer

Status code from the API.

isLicenseActive · boolean

Shows whether the license is currently active (true or false).

memberStatus · string

The membership customer status (for example ACTIVE, INACTIVE).

licenseCode · object

Detailed information about the license code.

licenseCode Structure (Object)

licenseCode · string

The license code value.

status · string

License status (for example ISSUED, ACTIVE, INACTIVE, DISABLED).

expiredAt · string

License expiration date (ISO 8601 datetime).

transactionId · string<uuid>

Related transaction ID.

productId · string<uuid>

ID of the associated product.

customerId · string<uuid>

Customer ID linked to the license.

customerName · string

Customer’s full name.

customerEmail · string

Customer’s email address.

createdAt · string

License creation timestamp (ISO 8601 datetime).

updatedAt · string

Last updated timestamp (ISO 8601 datetime).

membershipTierId · string<uuid>

ID of the membership tier associated with the license.

membershipTierName · string

Name of the membership tier.

memberPaymentLink · string

The member-specific payment link for subscription renewal.

Errors

400 Bad Request · object

Returned when licenseCode or productId is missing or invalid.

401 Unauthorized · object

Returned when the Authorization header is missing or invalid.

404 Not Found · object

Returned when the license code or product is not found.