Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: IMBA Partner Withdrawals API
version: 1.2.0
summary: B2B Partner API for USDT settlement, cards, eSIM, gift cards, and KYT
description: 'B2B Partner API. Production host `https://imbawallet.com` (no sandbox).
- Human docs: `https://api-docs.imbawallet.com` (guides + FAQ)
- Authenticate with `POST /auth/v1/partner/token` (assertion JWT), then call
`POST /api/partner/` with `Authorization: Bearer `
and a JSON body. Resource ids are body fields, not URL segments.
- Amounts are decimal strings.
- Response timestamps are UTC RFC 3339 with `Z`.
- Request time fields accept RFC 3339 or unix seconds (not milliseconds).
- Catalog calls (`/api/partner/gift_offers`, `/api/partner/esim_offers`,
`/api/partner/card_products`) are live availability and the live USDT price.
There is no `/quote` or `/availability` path.
- Order lookup: `POST /api/partner/document_get`. Secrets via product calls
after fulfillment (card JWE, gift `epin`, eSIM LPA) — not in webhooks
except `card.otp`.
- Card authorizations: `POST /api/partner/card_transactions`.
Unfreeze: `POST /api/partner/card_unfreeze` (only a freeze by you or the cardholder).
- Not in v1: purchase refund/cancel, card unload, card replacement.'
contact:
name: IMBA Partner Support
email: support@imbawallet.com
license:
name: Proprietary
url: https://imbawallet.com
servers:
- url: https://imbawallet.com
description: Production
tags:
- name: Withdrawals
description: USDT withdrawals from partner balance
paths:
/api/partner/withdraw_create:
post:
operationId: createPartnerWithdrawal
tags:
- Withdrawals
summary: Create USDT withdrawal
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawalCreateRequest'
responses:
'202':
description: Withdrawal accepted
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawalResponse'
'200':
description: Idempotent replay of the same ext_id + body
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawalResponse'
'409':
$ref: '#/components/responses/Error'
'422':
$ref: '#/components/responses/Error'
components:
responses:
Error:
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
schemas:
WithdrawalCreateRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
WithdrawalResponse:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true