imbawallet-com Withdrawals API

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