Track the deposit

Reports where a submitted deposit is, from the source-chain transaction receipt. Poll it until the status is terminal, and credit the user only on done.

Request

string

required

The provider from the original /deposit/quote response.

object

required

The receipt of the deposit transaction submitted on the source chain.

Show receipt

string

required

The hash of the submitted deposit transaction.

array

required

The transaction logs from the receipt.

Show logs[]

string

required

The log source address.

string[]

required

The log topics.

Response

string

One of pending, done, failed, expired. See Transaction statuses for what each means and when to credit the user.

object

Transaction hashes for the two legs, as they become known.

Show txHashes

string

Optional. The transaction that started the transfer on the source chain.

string

Optional. The transaction that delivered funds on the destination chain - present when status is done.

curl -X POST "$RHEON_API/deposit/status" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "rheon-router",
    "receipt": {
      "txHash": "0xabc123...",
      "logs": [
        {
          "address": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
          "topics": ["0xddf252ad..."]
        }
      ]
    }
  }'

{
  "status": "done",
  "txHashes": {
    "origin": "0xabc123...",
    "delivered": "0xdef456..."
  }
}

{
  "status": "pending",
  "txHashes": {
    "origin": "0xabc123..."
  }
}

Polling

Poll every few seconds until status is terminal (done, failed, or expired). Keep intervals above the rate limit (5 requests / 10s / IP). An expired transfer is auto-refunded by the routing layer - there is no refund call to make.

Errors

HTTP	`code`	When
400	`invalid_request`	`provider` or `receipt` is missing or malformed.
429	`rate_limited`	Over the rate limit (5 requests / 10s / IP).
500	`internal`	Unexpected server error.

Getting started

Crypto deposits

Card payments

Bank transfers

Track the deposit

Request

Response

Polling

Errors

​Request

​Response

​Polling

​Errors

Request

Response

Polling

Errors