Skip to main content
POST
Refund a failed deposit

Headers

x-api-key
string

API key for authentication (omit when sending Authorization)

Example:

"your-api-key"

authorization
string

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Example:

"Bearer eyJhbGciOi..."

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