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 base USD value of every APPROVED live verification: $0.015 per $0.15 verification.

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 base USD value of each attributed verification — at the $0.15 base price that is $0.015 per approved KYC.

• Approved-only, by design. Commission mirrors billing: callers are charged only on approved verifications, so only approved verifications earn commission.
• Self-calls earn nothing. Calling your own partner URL from your own account creates a normal verification but pays no commission.
• 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.

Read the fee schedule#

Returns the current minimum and fee schedule (values are platform-managed):

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

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#