Create OTC Withdrawal (one-shot)

curl --request POST \
  --url https://crypto.westminister.tech/api/v1/auth/otc/withdrawals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": "USDT",
  "crypto_amount": "100.50",
  "usdt_amount": "100.50",
  "fiat_amount": "15000.00",
  "fiat_currency": "KES",
  "method": "bank",
  "from_wallet_id": "770e8400-e29b-41d4-a716-446655440002",
  "payout_bank_account": "1234567890",
  "payout_bank_name": "Equity Bank"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "asset": "<string>",
  "crypto_amount": "<string>",
  "usdt_amount": "<string>",
  "fiat_amount": "<string>",
  "fiat_currency": "<string>",
  "from_wallet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "payout_bank_account": "<string>",
  "payout_bank_name": "<string>",
  "payout_phone_number": "<string>",
  "pricing_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fx_rate_quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "negotiated_fx_reference_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rejection_reason": "<string>",
  "rejected_at": "2023-11-07T05:31:56Z",
  "rejected_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "approved_at": "2023-11-07T05:31:56Z",
  "approved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "completed_at": "2023-11-07T05:31:56Z",
  "completed_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "internal_note": "<string>",
  "idempotency_key": "<string>",
  "submitted_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": "<string>"
}

POST

api

auth

otc

withdrawals

curl --request POST \
  --url https://crypto.westminister.tech/api/v1/auth/otc/withdrawals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": "USDT",
  "crypto_amount": "100.50",
  "usdt_amount": "100.50",
  "fiat_amount": "15000.00",
  "fiat_currency": "KES",
  "method": "bank",
  "from_wallet_id": "770e8400-e29b-41d4-a716-446655440002",
  "payout_bank_account": "1234567890",
  "payout_bank_name": "Equity Bank"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "asset": "<string>",
  "crypto_amount": "<string>",
  "usdt_amount": "<string>",
  "fiat_amount": "<string>",
  "fiat_currency": "<string>",
  "from_wallet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "payout_bank_account": "<string>",
  "payout_bank_name": "<string>",
  "payout_phone_number": "<string>",
  "pricing_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fx_rate_quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "negotiated_fx_reference_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rejection_reason": "<string>",
  "rejected_at": "2023-11-07T05:31:56Z",
  "rejected_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "approved_at": "2023-11-07T05:31:56Z",
  "approved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "completed_at": "2023-11-07T05:31:56Z",
  "completed_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "internal_note": "<string>",
  "idempotency_key": "<string>",
  "submitted_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

asset

enum<string>

required

Available options:

USDT,

USDC

crypto_amount

string

required

fiat_amount

string

required

fiat_currency

string

required

Active three-letter ISO code in fiat_currencies. List via GET /api/v1/auth/fiat-currencies.

method

enum<string>

required

Available options:

bank,

mpesa

from_wallet_id

string<uuid>

required

usdt_amount

string

Deprecated alias for crypto_amount

payout_bank_account

string

Required for bank

payout_bank_name

string

Required for bank

payout_phone_number

string

Required for mpesa

pricing_profile_id

string<uuid>

Optional. When set, fx_rate_quote_id is required. Profile flow_type must be b2b (OTC desk). Must match asset, fiat_currency, and wallet network.

fx_rate_quote_id

string<uuid>

Optional. Active quote matching the pricing profile scope.

Response

Withdrawal created

string<uuid>

merchant_id

string<uuid>

asset

string | null

crypto_amount

string

usdt_amount

string | null

Backward-compatible alias for crypto_amount

fiat_amount

string

fiat_currency

string

method

enum<string>

Available options:

bank,

mpesa

status

enum<string>

Available options:

draft,

priced,

pending,

approved,

processing,

completed,

rejected

from_wallet_id

string<uuid> | null

payout_bank_account

string | null

payout_bank_name

string | null

payout_phone_number

string | null

pricing_profile_id

string<uuid> | null

fx_rate_quote_id

string<uuid> | null

negotiated_fx_reference_id

string<uuid> | null

rejection_reason

string | null

rejected_at

string<date-time> | null

rejected_by

string<uuid> | null

approved_at

string<date-time> | null

approved_by

string<uuid> | null

transfer_id

string<uuid> | null

completed_at

string<date-time> | null

completed_by

string<uuid> | null

internal_note

string | null

idempotency_key

string | null

submitted_at

string<date-time> | null

created_at

string<date-time>

updated_at

string<date-time>

OTC Deposits

Offers

Users

Wallets-Users

Merchants

Orders

Transactions

Payment

OTC Desk

Mobile Money C2B

OTC Config

Fiat Currencies

Countries

Files

OTC Withdrawals

Pricing

Transfers

Stablecoin Swaps

Multisig

Escrow Wallets

Balances

Create OTC Withdrawal (one-shot)

Authorizations

Body

Response