Vendor Onboarding Wizard

5-step setup · paste vendor docs · auto-parse endpoint + auth + cost · test in sandbox · go live in 10 minutes

Identify

Auto-parse

Credentials

Test

Activate

1 · Identify vendor

Tell us what you're adding · category + name

2 · Auto-parse vendor API docs

Paste vendor's OpenAPI / Swagger / curl docs · we extract endpoint · auth · cost

OpenAPI / Swagger URL (if available)

We fetch + parse · extracts paths · auth · request/response schemas

Or paste curl example / API documentation

✓

Auto-detected:
Endpoint: https://api.karza.in/v3/pan · Method: POST · Auth: x-karza-key header · Cost: ₹2.00 · SLA: 99.8% · p95: 180ms

3 · Credentials & routing

API keys (encrypted at rest) · routing priority · cost

UAT (sandbox) API key

Used in UAT mode · NOT billed · safe for testing customer journeys

Live (production) API key

⚠ Used for real customer calls · billed by vendor · encrypted with AES-256 + KMS

Webhook callback URL (if vendor sends async)

Cost / call (₹)

SLA latency target (ms)

SLA success target (%)

Routing priority

4 · Test connection

Run health check + sample call · verify everything works before going live

✓

Connection successful
TCP reachable · TLS verified · auth accepted · sample call returned 200 · 142ms · sandbox mode

Sample request: POST https://api.karza.in/v3/pan
Headers: x-karza-key: kr_test_***
Body: {"pan":"ABCPS1234F","consent":"Y"}

Response (200): {"status":"valid","name_match":"high","aadhaar_link":"linked","mode":"sandbox"}
Latency: 142ms · within SLA target (180ms)

5 · Activate

Final review · save to provider master · enable routing

Vendor: Karza PAN verify
Category: 📇 PAN verify (§139AA)
Endpoint: https://api.karza.in/v3/pan
Auth: x-karza-key header · key encrypted
Cost: ₹2.00 per call
SLA: 99.8% · p95 180ms
Priority: Secondary · fallback to NSDL · Karza · primary in stack
UAT key: ✓ configured · sandbox test passed (142ms)
Live key: ✓ configured · production-ready
Webhook callback: https://api.kyc.zyroai.com/v1/callbacks/karza

Initial mode

What happens on activate:
· Saved to /providers master (177 → 178)
· Health check loop tests every 5 min
· Smart routing weights recomputed · routing engine picks up new option
· Tenant capability view auto-refreshes (those on Live mode see new category enable if applicable)
· Webhook /sla-alerts fires if vendor breaks SLA
· Billing reconciliation expects vendor invoice next month