AI setup

Setting up a billing catalog by hand — products, plans, features, credit currencies, grant rules, packages — is the slow part of adopting any billing engine. Asterix, UnitPay’s onboarding agent, does the first draft for you: give it your pricing page and it builds a working catalog in your sandbox.

What it does

You give Asterix a URL (your pricing or plans page). It reads the page, extracts the pricing into a structured catalog, and creates the objects live in your sandbox org — in dependency order:

product → credit currencies → billable metrics → features →
plan tiers → plans (charges · entitlements · grant rules) → credit packages

Credit setup is first-class: Asterix chooses the right denomination (unit vs fiat) per wallet, attaches recurring/one-time grant rules to plans, and creates credit packages for top-ups — the same shapes you’d model by hand. It also returns a tracking contract: the exact eventNames to send to track so your usage lines up with the catalog it built.

Run it

Dashboard
API

In the dashboard, open Import pricing, paste your pricing URL, and watch Asterix build the catalog live. This is the easiest way to start.

Kick off a run and poll for the result:

curl https://api.useunitpay.com/v1/onboarding \
  -H "x-api-key: $UNITPAY_SECRET_KEY" \
  -H "content-type: application/json" \
  -d '{ "url": "https://yourcompany.com/pricing" }'

Response

{ "id": "onb_...", "status": "queued" }

curl https://api.useunitpay.com/v1/onboarding/onb_... \
  -H "x-api-key: $UNITPAY_SECRET_KEY"

The result reports what was created, skipped, and failed, plus the productId and the tracking contract. Prefer a live stream? POST /v1/onboarding/stream returns server-sent events as the agent works.

It’s a first draft — verify it

Asterix applies changes autonomously to your sandbox — there’s no approval step before objects are created. Nothing goes live: sandbox is a safe, throwaway copy. Always review the drafted catalog before you rely on it.

Treat the output as a fast starting point, not a final answer:

It reads a URL, not prose or screenshots. Point it at a real pricing page.
Obscured pages extract poorly. Prices hidden behind JavaScript or rendered as images may be missed — check them.
Review before going live. Confirm prices, credit amounts, and grant cadences, then promote to live yourself.
Prefer to build by hand? Every object Asterix creates, you can create directly — see Billing for the catalog API and Credits for the credit side.

What it does

Run it

It’s a first draft — verify it

Next steps

Quickstart

Credits

​What it does

​Run it

​It’s a first draft — verify it

​Next steps

Quickstart

Credits

What it does

Run it

It’s a first draft — verify it

Next steps