Bank payout status

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

{
  "id": "bpo_77c2e1f430",
  "status": "settled",
  "fiatAmount": "731.40",
  "fiatCurrency": "GBP",
  "rail": "faster_payments",
  "bankReference": "RHN-91204",
  "depositTxHash": "0x8ad3...41f7",
  "updatedAt": "2026-09-02T18:02:19Z"
}

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

Needs the bank-payouts permission on your API key.

Request

string

required

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

Response

string

The payout id, echoed back.

string

One of pending, converting, sent, settled, rejected, returned. See Statuses.

string

What was paid out, once known.

string

The currency fiatAmount is in.

string

The rail the transfer actually went out on.

string

The reference carried on the transfer, for reconciling against the beneficiary’s statement.

string

The transaction that funded the payout, once seen on chain.

string

Present on rejected and returned: why, in the partner’s words.

string

ISO 8601 of the last change.

A returned payout is not a failed one. A receiving bank can bounce a transfer days after it was sent - wrong beneficiary name, closed account, its own checks. The status becomes returned and the value comes back as stablecoin to the sending wallet, minus the rail’s own cost. Treat settled as final and nothing before it.

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

{
  "id": "bpo_77c2e1f430",
  "status": "settled",
  "fiatAmount": "731.40",
  "fiatCurrency": "GBP",
  "rail": "faster_payments",
  "bankReference": "RHN-91204",
  "depositTxHash": "0x8ad3...41f7",
  "updatedAt": "2026-09-02T18:02:19Z"
}

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-payouts permission.
404	`not_found`	No such payout 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

Bank payout status

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors