Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.onswitch.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Developer fees let you charge a share of each payment amount and route it to a beneficiary wallet you control. Switch calculates the fee from the stablecoin side of the transaction when you add developer_fee and developer_recipient on quote and initiate requests. When the offramp completes, Switch sends your fee to developer_recipient automatically.
To see how a fee changes output amounts before you initiate a payment, use Get quote endpoint with the same payment request payload.

​
How developer fees work

1

Setting fee

On POST /offramp/quote and POST /offramp/initiate, pass developer_fee and developer_recipient. Omit them or set developer_fee to 0 if you are not charging a fee.
2

Fee settlement

After the payment completes, Switch pays your developer_fee portion to developer_recipient automatically — no separate action required.

​
Fee model

Switch enables you to charge any percentage as a developer fee on the incoming stablecoin payment amount:
  • developer_fee — Number from 0 to 100: the percentage of the payment amount taken as your fee (for example, 0.5 for 0.5%, 2 for 2%).
  • developer_recipient — Blockchain address that should receive the developer fee.
developer_recipient wallet address must be able to receive the stablecoin and network of the payment.

​
Calculation example

Payment of 100 USDC with developer_fee: 0.2 (0.2%, i.e. 20 bps):
  • Your fee: 100 × 0.002 = 0.2 USDC to developer_recipient.
With developer_fee: 0.5:
  • Your fee: 0.5 USDC on a 100 USDC payment (0.5% of 100).

​
Need help?

Email support

Send us a message and we will get back to you shortly.

Book a demo

Hop on a call with us.