Zoth Payment API

India API

Backend-for-frontend API for sub-accounts, KYC, banking, wallets, deposits, and on/off-ramp trading. All routes are served under /api/india.

Try requests in Swagger explorer

Reference

Endpoint Overview

India routes are grouped by domain. Use the interactive Swagger explorer for full request/response schemas and to send live requests.

Connections must be made over HTTPS with a minimum of TLS 1.2.
All endpoints require a Bearer token in the Authorization header.
Request and response bodies use application/json unless noted otherwise.

Connectivity

Host Details

All India API requests are served from the Zoth Payment host over HTTPS on port 443.

Environment	Base URL	API prefix
Production	https://zpayments.zoth.io	/api/india

Example: https://zpayments.zoth.io/api/india/accounts

Security

Authentication

All requests must include a Bearer token and JSON content type for non-multipart endpoints.

Header	Value
Authorization	Bearer {accessToken}
Content-Type	application/json

Endpoints

Accounts

Main account and sub-account management.

GET/api/india/main-account

Get main account details.

GET/api/india/accounts

List sub-accounts.

Optional query: kyc_status, aml_status.

POST/api/india/accounts

Create a sub-account.

GET/api/india/accounts/{id}

Get a sub-account by id.

PATCH/api/india/accounts/{id}

Update a sub-account.

Endpoints

KYC

KYC sessions and document submission.

GET/api/india/kyc/{accountId}

Get KYC info for an account.

POST/api/india/kyc/initiate

Initiate a KYC session.

POST/api/india/kyc/cleanup

Cleanup KYC sessions and documents for an account.

POST/api/india/kyc/document

Submit a KYC document (JSON).

POST/api/india/kyc/document-file

Submit a KYC document file (multipart/form-data).

Endpoints

Bank

Bank account management for sub-accounts.

GET/api/india/bank?account_id={account_id}

List bank accounts for an account.

POST/api/india/bank

Add a bank account.

POST/api/india/bank/delete

Delete a bank account.

Endpoints

Wallet

Whitelisted wallets and trading balances.

GET/api/india/wallet/addresses?account_id={account_id}

List whitelisted wallet addresses.

POST/api/india/wallet/addresses

Whitelist a wallet address.

GET/api/india/wallet/balance?account_id={account_id}

Get trading wallet balances.

Endpoints

Deposit

Fiat and crypto deposits.

GET/api/india/deposit/details?account_id={account_id}

Get fiat deposit details.

Optional query: currency (defaults to INR).

POST/api/india/deposit/fiat

Create a fiat deposit.

GET/api/india/deposit/addresses?asset={asset}&chain={chain}

Get crypto deposit addresses.

POST/api/india/deposit/crypto

Create a crypto deposit.

Endpoints

Onramp

Fiat to crypto orders.

GET/api/india/onramp/routes

List supported onramp routes.

POST/api/india/onramp/quote

Generate an onramp quote.

POST/api/india/onramp/place-order

Place an onramp order.

GET/api/india/onramp/orders?account_id={account_id}

List onramp orders.

Optional query: status.

Endpoints

Offramp

Crypto to fiat orders.

GET/api/india/offramp/routes

List supported offramp routes.

POST/api/india/offramp/quote

Generate an offramp quote.

POST/api/india/offramp/place-order

Place an offramp order.

GET/api/india/offramp/orders?account_id={account_id}

List offramp orders.

Optional query: status.