Partner docs

Vendor Affiliate API

Create Mintit users, assign PRO with a token amount, reup tokens additively, and reconcile — with welcome email credentials.

Authentication

# Preferred through the public proxy (Apache may strip Authorization):
X-Mintit-Vendor-Key: mit_vend_<prefix>_<secret>

# Also accepted:
Authorization: Bearer mit_vend_<prefix>_<secret>

Base URL: https://mint.synczersolutions.com/api.php?path=/api/v1/...

Optional idempotency: Idempotency-Key: unique-string on write endpoints.

Plans & token caps

Affiliate minting defaults to plan pro (max_tokens 50000).
Typical signup amounts: 200 / 400 / 800 tokens.
Typical reup amounts: 250 – 1000 tokens (additive, does not reset).
Vendor allow-list must include pro. Token spend counts against the vendor token_budget.

Endpoints

Method	Path	Purpose
GET	`/api/v1/vendor/me`	Vendor profile, budgets, scopes
GET	`/api/v1/vendor/plans`	Plans this vendor may assign
POST	`/api/v1/vendor/users`	Create user + welcome email (+ optional initial tokens on PRO)
POST	`/api/v1/vendor/users/:id/subscription`	Assign/replace plan allotment (defaults to PRO)
POST	`/api/v1/vendor/users/:id/tokens`	Reup — add N tokens (does not reset)
GET	`/api/v1/vendor/users`	List linked users
GET	`/api/v1/vendor/reconcile`	Reconcile report

Create user (welcome email)

Omit password. Mintit generates a temporary password and emails login details to the user. Response includes welcome_email_sent. temporary_password is only returned if email delivery failed.

curl -sS -X POST 'https://mint.synczersolutions.com/api.php?path=/api/v1/vendor/users' \
  -H 'X-Mintit-Vendor-Key: mit_vend_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: acme-user-1001' \
  -d '{
    "email": "creator@client.com",
    "display_name": "Client Creator",
    "external_ref": "CRM-1001",
    "tokens": 400,
    "create_creator": true,
    "brand_name": "Client Brand"
  }'

tokens (or token_allotment) assigns PRO with that allotment in the same call.

Reup tokens (additive)

curl -sS -X POST 'https://mint.synczersolutions.com/api.php?path=/api/v1/vendor/users/123/tokens' \
  -H 'X-Mintit-Vendor-Key: mit_vend_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: acme-reup-1001' \
  -d '{ "tokens": 250 }'

Example: user has 400 → reup 250 → 650. Ensures PRO is active. Does not replace the prior allotment.

Assign / replace plan allotment

curl -sS -X POST 'https://mint.synczersolutions.com/api.php?path=/api/v1/vendor/users/123/subscription' \
  -H 'X-Mintit-Vendor-Key: mit_vend_...' \
  -H 'Content-Type: application/json' \
  -d '{ "plan_code": "pro", "token_allotment": 800, "period_days": 30 }'

Use this to set/replace an allotment. Prefer /tokens for top-ups.

Reconcile

curl -sS 'https://mint.synczersolutions.com/api.php?path=/api/v1/vendor/reconcile' \
  -H 'X-Mintit-Vendor-Key: mit_vend_...'