Set Developer Fee
Set or change your developer fee: a percent, a fixed USD amount per transaction, or both. Fields you omit keep their current value; null stops charging that part. Applies to routing transactions quoted after the change; transactions already quoted keep their frozen fees.
X-Api-Key<token>API key in format: sti_env_prefix_secret
Changes the fields you send and keeps the ones you omit; null stops charging that part. At least one part must remain: use DELETE to remove the developer fee altogether.
application/json- body
Changes the fields you send and keeps the ones you omit; null stops charging that part. At least one part must remain: use DELETE to remove the developer fee altogether.
developer_fee_percent?|Omit to leave your percentage as it is; null to stop charging it.
developer_fee_fixed_amount?|Omit to leave your fixed amount as it is; null to stop charging it.
Default Response
application/json- response
developer_fee_percent*|Your developer fee percent; null when you charge no percentage.
developer_fee_fixed_amount*|Your fixed developer fee per transaction, in USD; null when you charge no fixed amount.
curl -X PUT 'https://api.sandbox.stables.money/api/v1/developer-fee' \ -H 'Content-Type: application/json' \ -d '{}'{ "developer_fee_percent": "string", "developer_fee_fixed_amount": "string"}Sets or changes your developer fee: a percentage, a fixed USD amount per transaction, or both.
Request fields
| Field | Description |
|---|---|
developer_fee_percent | Your conversion fee, as a percent. A decimal string with at most two decimals, greater than 0 and at most 10. |
developer_fee_fixed_amount | Your fixed fee, in USD. A decimal string with at most two decimals, greater than 0 and at most 50. |
Send at least one of the two. Each field is treated on its own:
- Sent with a value: that part is set to the value.
- Left out: that part keeps its current value. A request that sends only
developer_fee_percentnever changes your fixed fee. - Sent as
null: that part is no longer charged.
At least one part must remain after the change. A request that would remove both returns 422 with code DEVELOPER_FEE_REQUIRED; use Remove Developer Fee for that.
The change applies to quotes created afterwards. Quotes and transfers that already exist keep the fee they were priced with.
Errors
| Status | Code | When |
|---|---|---|
400 | Neither field was sent, or a value is not a decimal string. | |
422 | INVALID_DEVELOPER_FEE_PERCENT | The percentage is 0 or above 10. |
422 | INVALID_DEVELOPER_FEE_FIXED_AMOUNT | The fixed amount is 0 or above 50. |
422 | DEVELOPER_FEE_REQUIRED | The change would leave no part of the developer fee in place. |
Related: Developer fees in the Developer Platform guide.