Partner program

Your partner URL behaves exactly like /v1/verifications — the developers you bring integrate against it with their own API keys and are billed normally. You earn 10% of the price charged for every APPROVED LIVE verification: $0.015 per approved AI KYC at the $0.15 list price.

How it works#

Your partner API URL#

The partner URL is a prefix in front of the standard verifications API. All three verification endpoints exist under it and behave identically to their standard counterparts:

• Authentication is unchanged. The caller authenticates with their own API key (Authorization: Bearer ok_live_...) and is billed normally on their own account — your URL never changes who pays.
• Request and response are unchanged. Same body, same idempotency behavior, same status model and webhooks.
• Unknown or suspended codes fail fast. A request to a partner URL whose code does not exist or is suspended returns 404 with error code PARTNER_NOT_FOUND before any work happens.

Example: create a verification through a partner URL#

This is what a developer you referred runs — their own key, your URL (here with the example code AB2CD3EF):

curl https://api.okias.io/v1/p/AB2CD3EF/verifications \
  -H "Authorization: Bearer ok_live_..." \
  -H "Idempotency-Key: 9f2c4a1b-1e33-4c07-9c1e-2b7f0d5a1a10" \
  -H "Content-Type: application/json" \
  -d '{
    "level": ["FULL_KYC"],
    "country": "pk",
    "doc_type": "NATIONAL_ID",
    "end_user_ref": "user_8842"
  }'

Attribution: URL and referral link#

There are two attribution paths, and the partner URL always wins:

Commission mechanics#

You earn 10% of the price charged for each attributed verification that ends approved in LIVE mode — at the $0.15 AI KYC list price that is $0.015 per approved AI KYC.

Commission by product#

Commission is calculated on the credits charged for the approved verification, so it follows the product the caller used:

• Approved LIVE only, by design. Commission mirrors billing: callers are charged only on approved verifications, so only approved LIVE verifications earn commission.
• Self-calls earn nothing. Calling your own partner URL from your own account creates a normal verification but pays no commission.
• Reseller-managed clients earn nothing. Verifications of client accounts created by a reseller are billed to the reseller and pay no commission.
• Paid credits and cooling period. Today the charged credits may include free trial credits, and commission is booked when the verification is approved. Rules that limit commission to paid credits and add a cooling period are being built; this page will say so when they apply.
• Everything is ledgered. Each commission is an entry in an append-only USD ledger on your dashboard, tied to the verification that produced it.

Payouts#

Request a payout from Dashboard → Partners once your unpaid balance reaches the $30 minimum. A processing fee is withheld from the requested amount — you receive net = amount − fee. Your own account must hold an approved LIVE identity verification before a payout can be requested (403 PARTNER_KYC_REQUIRED otherwise).

Read the fee schedule#

Returns the current minimum, fee schedule and dual-control threshold (values are platform-managed; the same values are published in the partner block of GET /v1/pricing):

{
  "min_payout_usd": 30,
  "crypto": {
    "flat_usd": 1.2,
    "networks": "any (USDT TRC20 / BEP20 / ERC20 / other)"
  },
  "fiat": {
    "base_usd": 3.5,
    "fraction": 0.05,
    "bps": 500,
    "rails": ["BANK", "PAYPAL", "WISE"]
  },
  "dual_control_threshold_usd": 500
}

Request a payout#

{
  "method": "USDT_TRC20",
  "amount_usd": 100,
  "payout_details": { "address": "TX7k3...your wallet" }
}

{
  "id": "cms82b1qf003goea2t6n8p2kj",
  "amount_usd": "100.00",
  "fee_usd": "1.20",
  "net_usd": "98.80",
  "method": "USDT_TRC20",
  "state": "REQUESTED",
  "created_at": "2026-07-30T10:12:00.000Z"
}

Payout errors#

Good to know#

• Who pays for the verification? Always the caller, on their own account and credits. Your commission comes from OKIAS, never on top of the caller's price.
• Does the partner URL change latency or behavior? No — it is the same pipeline with an attribution stamp. Same decisions, same webhooks, same pricing.
• What if my account is suspended? Your URL stops resolving (404 PARTNER_NOT_FOUND), so developers using it should switch back to /v1/verifications — their integrations otherwise keep working unchanged.
• Where do I see my URL, code and earnings? On Dashboard → Partners, or via GET /v1/partners/me (api_call_url, referral_code, balances and stats).
• Questions or higher-volume arrangements: email sales@okias.io.

Next steps#