Card payout status

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

{
  "id": "cpo_41b8e0d7a2",
  "status": "sent",
  "fiatAmount": "84.10",
  "fiatCurrency": "EUR",
  "depositTxHash": "0x6b1c...c39a",
  "updatedAt": "2026-09-02T17:52:41Z"
}

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

Needs the card-payouts permission on your API key.

Request

string

required

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

Response

string

The payout id, echoed back.

string

One of pending, converting, sent, settled, rejected, returned. Read the vocabulary in Statuses rather than matching strings you saw once.

string

What actually landed, once known. Equals the quoted figure unless the user sent a different amount than quoted.

string

The currency fiatAmount is in.

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.

sent is not settled. sent means the payout left the partner; card schemes take from minutes to several working days to post it to the cardholder. Telling a user the money has arrived at sent produces support tickets.

A payout the user underfunded does not fail - it converts what arrived and pays that out, so fiatAmount comes back lower than quoted. Compare it against your own record rather than assuming the quote held.

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

{
  "id": "cpo_41b8e0d7a2",
  "status": "sent",
  "fiatAmount": "84.10",
  "fiatCurrency": "EUR",
  "depositTxHash": "0x6b1c...c39a",
  "updatedAt": "2026-09-02T17:52:41Z"
}

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 card-payouts permission.
404	`not_found`	No such payout under your key.
429	`rate_limited`	Over your key’s rate limit.
502	`upstream_error`	The payout partner is unavailable.
500	`internal`	Unexpected server error.

Getting started

Crypto deposits

Card payments

Card payouts

Bank transfers

Bank payouts

Virtual accounts

Reference

Card payout status

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors