Skip to main content
POST
Reject Bank Deposit (Admin Or otc_officer)

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

Body

application/json
rejection_reason
string
required

Response

200 - application/json

Deposit rejected

id
string<uuid>
merchant_id
string<uuid>
method
enum<string>
Available options:
bank,
mpesa
fiat_amount
string
fiat_currency
string
status
enum<string>
Available options:
draft,
priced,
pending,
confirmed,
rejected,
credited
payment_reference
string | null

Bank wire reference. Globally unique (case-insensitive) when set.

proof_url
string | null

Relative path to the bank proof PDF. Prepend API base URL for GET in browsers (GET /otc-deposits-proof/..., no auth).

Example:

"/otc-deposits-proof/ce6e4186-16fe-4e0d-a97d-7638f11c6063/8251c719-0941-46da-8792-5acce5e5efc8.pdf"

transfer_date
string<date-time> | null
merchant_request_id
string | null
checkout_request_id
string | null
mpesa_receipt_number
string | null
mpesa_phone_number
string | null
sender_account_name
string | null
sender_account_number_last4
string | null
sender_bank_name
string | null
sender_bank_branch
string | null
receipt_number
string | null
receipt_uploaded_at
string<date-time> | null
proof_file_name
string | null
proof_mime_type
string | null
proof_size_bytes
integer<int64> | null
proof_file_sha256
string | null
requested_asset
string | null
requested_network
string | null
requested_crypto_amount
string | null
pricing_profile_id
string<uuid> | null
fx_rate_quote_id
string<uuid> | null
negotiated_fx_reference_id
string<uuid> | null
confirmed_at
string<date-time> | null
confirmed_by
string<uuid> | null
rejected_at
string<date-time> | null
rejected_by
string<uuid> | null
rejection_reason
string | null
internal_note
string | null
credited_at
string<date-time> | null
credited_by
string<uuid> | null
usdt_amount
string | null
credited_asset
string | null
credited_crypto_amount
string | null
credited_to_address
string | null

Merchant blockchain address to receive USDT/USDC on treasury credit. Resolved from the default wallet for requested_network on the master merchant ledger or a sub-vendor under that merchant. Set on draft, one-shot create (when requested_network is sent), quote refresh, and list backfill when missing.

Example:

"TJyF42dRr18tSiXV9Cf7JtYUtTbqAGZg94"

to_wallet_id
string<uuid> | null

Internal wallets.id paired with credited_to_address.

payout_to_address
string | null
read-only

Same as credited_to_address when the API enriches the response (list/detail). Omitted when no wallet can be resolved.

payout_to_wallet_id
string<uuid> | null
read-only

Same as to_wallet_id on enriched responses.

payout_network
string | null
read-only

Network from the resolved payout wallet (tron or ethereum).

payout_asset
string | null
read-only

Mirrors requested_asset when enrichment runs.

transfer_id
string<uuid> | null
idempotency_key
string | null
submitted_at
string<date-time> | null
assigned_to_user_id
string<uuid> | null
created_at
string<date-time>
updated_at
string<date-time>