Boni

Verification API

Verify identity, business and vehicle inputs through one API.

Integrate Aadhaar, PAN, GSTIN, vehicle and FASTag checks through Boni. Test sandbox responses, control endpoint access and keep verification outcomes with your workflow.

For: Product and platform teams adding Indian-record verification to onboarding, business checks and vehicle operations.

Verification API: operating workflow
  1. 01Choose the endpoint
  2. 02Test the sandbox
  3. 03Connect your server
  4. 04Handle the result

Shared context · Clear responsibility · Review where it matters

Five check families
Aadhaar, PAN, GSTIN, vehicle registration and FASTag observations through the published request and response contract.
A separate sandbox
Build against deterministic test records with separate environment credentials. Sandbox checks do not call production data sources.
Reviewable outcomes
Keep the request reference, returned status and permitted data with the business step that asked for the check.

How it works

Make the verification result useful to the next decision.

Choose the check your workflow actually needs, collect the required input and permission, then handle each returned outcome explicitly. A response is evidence for your process—not an automatic instruction to approve an account, lend money or release a vehicle.

  1. 01

    Choose the endpoint

    Agree the intended use, enabled checks and environment. Your subscription determines endpoint access and the request limits assigned to it.

  2. 02

    Test the sandbox

    Use the documented synthetic inputs to exercise verified, no-record and error branches before introducing real personal or business records.

  3. 03

    Connect your server

    Keep the client ID and secret server-side. Send the documented inputs and a unique idempotency key; reuse a key only for the exact same request body.

  4. 04

    Handle the result

    Read the status and request reference. Continue an OTP challenge where required, distinguish no record from a service failure, and keep a human review path for your business decision.

Product scope

What the product covers.

Aadhaar and PAN verification inputs with the document owner’s consent and the production OTP flow where required.

GSTIN checks for the business-registration input your application supplies.

Vehicle-registration checks using the vehicle identifier and the approved response contract.

FASTag observations using a vehicle number or chassis number, with exactly one identifier per request.

Separate authenticated sandbox and production subscriptions and credentials.

Endpoint access, configurable quota windows, request references and usage reads.

Operating areas

Build the complete result path, not just the successful response.

Onboarding and consent

Collect only what the selected operation needs. Aadhaar and PAN requests require the document owner’s consent; production may require the owner to complete an OTP challenge.

  • Purpose and required input
  • Owner consent where required
  • OTP-required and expired-challenge handling

Business and vehicle decisions

Attach the returned status and request reference to the correct business record. A no-record result is different from a successful match or an unavailable data source.

  • Correct record and identifier
  • Verified versus no record
  • Review and correction path

Integration operations

Treat invalid input, disabled access, quota exhaustion and temporary provider failure as different operating conditions. Respect Retry-After and retain the original request key when recovering the same body.

  • Separate environment credentials
  • Endpoint and quota controls
  • Usage by endpoint and outcome

Built around your business operations.

Connect the right people, records and systems around your workflow, with clear ownership and the controls your team needs.

Credentials stay with your server

Do not put client secrets in browser code, a mobile bundle or a public URL. Sandbox and production use their own credentials and enabled subscriptions.

FASTag is an observation source

FASTag returns sparse toll observations within its documented rolling window, not continuous GPS tracking. It does not provide wallet balances, recharge or debit transactions; an empty observation result is valid.

The business decision stays with you

Verification supports your approved workflow. It is not a universal trust score, a credit decision or a guarantee that every input has a matching record.

Questions

Common questions

Which verification checks are included?

The published API covers Aadhaar, PAN, GSTIN, vehicle registration and FASTag observations. The checks enabled for your subscription determine what your application can call.

How should we test the integration?

Use the separately authenticated sandbox and documented synthetic values. It returns deterministic test records and does not call production data sources. Build the no-record and error paths as well as the verified path.

How does retrying a request work?

Use the original idempotency key only with the original request body. A different body needs a new key. Follow the documented response and Retry-After rather than submit new requests blindly.

Does FASTag provide real-time GPS or account balances?

It provides sparse toll observations within the documented rolling window, not continuous GPS, balances, recharge or debit transactions. An empty observation result is a valid outcome.

How do we get production access?

Discuss the intended use, required endpoints and integration responsibilities with Boni. Production access is activated for the agreed organization, environment and subscription.

See it working for your business

Bring your process, files and team. See the workflow configured around your business.

Discuss API access