IMBA Partner API

IMBA Partner API is a server-to-server HTTP API for B2B integrators. Your backend manages a USDT settlement balance and issues products (virtual cards, eSIM, gift cards) to your end customers. End users do not log into IMBA Wallet and do not receive a client JWT. All calls use your partner access token.


API	`https://api.imbawallet.com`
Docs	`https://api-docs.imbawallet.com`
Support	support@imbawallet.com

Capabilities

Area	What you can do
Money	Read balance, sticky USDT TRC-20 deposit address, withdraw USDT, pull reconciliation
Cards	Tenant catalog, issue, get (JWE), balance, top up, freeze
eSIM	Offers, purchase, top up, get activation (LPA)
Gift cards	Offers, purchase, get receipt (code / epin)
Ops	Poll by `ext_id`, HMAC webhooks for terminal statuses

How integration works

Your server
  │  1. Sign short-lived assertion JWT (Ed25519)
  ▼
POST /auth/v1/partner/token
  │  2. Receive access_token (900s)
  ▼
GET|POST https://api.imbawallet.com/partner/...
  │  3. Authorization: Bearer <access_token>
  ▼
IMBA processes async work → webhooks + GET documents / products

Start here

Quickstart

Token → balance → deposit address in minutes

Authentication

Ed25519 assertion, scopes, isolation

Webhooks

HMAC signature and event catalog

API reference

Full OpenAPI endpoint list

Onboarding checklist

IMBA issues for your tenant:

partner_id
Ed25519 credential (kid + registered public key) and scopes
Webhook URL + HMAC secret (you provide the URL and secret)
X25519 public key for card JWE (recommended / default)
Enabled products (card products, eSIM/gift catalogs as agreed)

You never send partner_id in the request body or URL — it comes only from the verified access token.

Quickstart

⌘I

Get started

Money

Products

Operations

IMBA Partner API

IMBA Partner API

Capabilities

How integration works

Start here

Quickstart

Authentication

Webhooks

API reference

Onboarding checklist

​IMBA Partner API

​Capabilities

​How integration works

​Start here

Quickstart

Authentication

Webhooks

API reference

​Onboarding checklist

IMBA Partner API

Capabilities

How integration works

Start here

Onboarding checklist