Processing

Refund a deposit

Returns deposit funds to a specified address on the source chain.

post/deposits/{id}/refund

Request

Base URL
https://v1.orchestrator.rhinestone.dev/deposit-processor
Auth
- API key in header x-api-key
- or HTTP bearer
TypeScript
https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/docs/deposits/:id/refund/post.ts
A function with typed inputs. Its response is checked against the schema.

idstring required

Deposit id. Returned by GET /deposits.

Example:12345

x-api-keystring

API key for authentication

Example:your-api-key

recipientstring required

Address to receive the refunded tokens (EVM address or Solana public key). Must not be the address the deposit is already held at.

{
  "recipient": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"
}

Deposit refunded successfully

messagestring required

transactionHashstring required

amountstring required

Nov 6, 2026aa1767d704fa Revision changes
- info
  the endpoint scheme security internalProjectBearer was added to the API
- info
  the endpoint scheme security tenantApiKey was added to the API
- info
  the header request parameter x-api-key became optional
Sep 30, 2026a6fd693c3d5f Revision changes
- info
  added the non-success response with the status
- info
  added the non-success response with the status