Marketplace

Marketplace apps

Sell your software on the NewRich marketplace with API-based license fulfillment.

Marketplace apps

Sell your web application on the NewRich App Store without handing NewRich pre-generated license keys. Instead, you host a small license API on your app. When a customer checks out, App Store calls your API to issue an email-bound redemption code; the customer registers on your site to activate access.

Who this is for

Role	Responsibility
App developer	Implement the license API, `X-Licensing-Api-Key` validation, caller-domain allowlist, and customer registration page
NewRich team	Configure your product in App Store admin
Customer	Purchases on App Store, receives a redemption code, registers at your app

Every marketplace app uses the same license API contract documented here. App Store fulfills purchases by calling your endpoints — no per-app custom integration on the NewRich side.

End-to-end flow

Customer          App Store                    Your app
    |                 |                            |
    |-- checkout ---->|                            |
    |                 |-- POST /redemption_codes ->|
    |                 |<-- { code, status } -------|
    |<-- email code --|                            |
    |-- register --------------------------------->|
    |                 |                            | (code + email match)

Customer completes checkout on App Store.
App Store sends POST {license_api_url}/redemption_codes with the buyer's email and a unique order_id.
Your API returns a redemption code (HTTP 200, success: true).
App Store emails the code to the customer.
Customer opens your app at your registration page, enters the code and the same email used at checkout.
Your app creates their account and grants access.

On refund or dispute, App Store may call revoke and reactivate endpoints. Implement all three endpoints even though purchase fulfillment only uses generate today.

What you must build

Deliverable	Example
License API	`POST /api/v1/redemption_codes` (+ revoke, reactivate)
API key validation	`X-Licensing-Api-Key` header checked against `LICENSING_API_KEY`
Caller domain allowlist	Reject requests not from `apps.newrich.com`
Registration page	`https://dashboard.yourapp.com/register`

Share your license API base URL and customer app URL with the NewRich team when onboarding. NewRich will provide the license API key privately for App Store to send on each request.

Next steps

Read the full contract and implementation checklist in License API.

License API

Implement redemption-code licensing so NewRich App Store can fulfill marketplace purchases.