Skip to main content
POST
/
deposits
/
refund
Refund a failed deposit
curl --request POST \
  --url https://v1.orchestrator.rhinestone.dev/deposit-processor/deposits/refund \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "chain": "eip155:8453",
  "txHash": "0xabc123...",
  "account": "0xde0fdf9c06b404cc5e20543cb84cac9067102f19",
  "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "recipient": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"
}
'
{
  "message": "<string>",
  "transactionHash": "<string>",
  "amount": "<string>"
}

Headers

​
x-api-key
string
required

API key for authentication

Example:

"your-api-key"

Body

application/json
​
chain
string
required

CAIP-2 chain identifier of the deposit (e.g. "eip155:8453")

Pattern: ^[a-z0-9]+:[a-zA-Z0-9]+$
Example:

"eip155:8453"

​
txHash
string
required

Source transaction hash of the stuck deposit

Minimum string length: 1
Example:

"0xabc123..."

​
account
string
required

Managed account address that received the deposit (EVM address or Solana public key)

Minimum string length: 1
Example:

"0xde0fdf9c06b404cc5e20543cb84cac9067102f19"

​
token
string
required

Source token address. Use the zero address (0x000…000) for native transfers.

Minimum string length: 1
Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

​
recipient
string
required

Address to receive the refunded tokens (EVM address or Solana public key)

Minimum string length: 1
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

Response

Deposit refunded successfully

​
message
string
required
​
transactionHash
string
required
​
amount
string
required