One-off bank deposit status

curl -X POST "$RHEON_API/v1/bank/deposit/status" \
  -H "Authorization: Bearer $RHEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "bdp_3a71f0c9e4" }'

{
  "id": "bdp_3a71f0c9e4",
  "status": "settled",
  "fiatAmount": "500.00",
  "cryptoAmount": "537.21",
  "cryptoCurrency": "USDC",
  "settlementTxHash": "0x11ae...90d2",
  "updatedAt": "2026-09-02T18:22:04Z"
}

Returns where a one-off bank deposit stands. Poll it, or take the webhook - see Webhooks.

Needs the bank permission on your API key.

Request

string

required

The deposit id from POST /v1/bank/deposit.

Response

string

The deposit id, echoed back.

string

One of awaiting_funds, received, converting, settled, returned, expired. See Statuses.

string

What actually arrived, once received. Compare it with what you asked for - a user can send a different amount and it still settles.

string

What was delivered to the wallet, once settled.

string

Which asset was delivered. Read it rather than assuming USDC.

string

The on-chain transaction that delivered the stablecoin.

string

Present on returned: why the money went back.

string

ISO 8601 of the last change.

expired does not mean money was lost. Details stop accepting new payments at expiresAt, but a transfer already in flight still settles and moves the deposit to received. Do not tell a user their payment failed on expired alone.

curl -X POST "$RHEON_API/v1/bank/deposit/status" \
  -H "Authorization: Bearer $RHEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "bdp_3a71f0c9e4" }'

{
  "id": "bdp_3a71f0c9e4",
  "status": "settled",
  "fiatAmount": "500.00",
  "cryptoAmount": "537.21",
  "cryptoCurrency": "USDC",
  "settlementTxHash": "0x11ae...90d2",
  "updatedAt": "2026-09-02T18:22:04Z"
}

Errors

HTTP	`code`	When
400	`invalid_request`	`id` missing or malformed.
401	`unauthorized`	Missing, malformed, or unknown API key.
403	`permission_denied`	Your key does not carry the bank permission.
404	`not_found`	No such deposit under your key.
429	`rate_limited`	Over your key’s rate limit.
502	`upstream_error`	The banking partner is unavailable.
500	`internal`	Unexpected server error.

Getting started

Crypto deposits

Card payments

Card payouts

Bank transfers

Bank payouts

Virtual accounts

Reference

One-off bank deposit status

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors