Set Developer Fee

PUT
/api/v1/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.

Authorization

headerX-Api-Key<token>

API key in format: sti_env_prefix_secret

Request 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.

application/json
  1. 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.

Response Body

Default Response

application/json
  1. 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.

Example Request
curl -X PUT 'https://api.sandbox.stables.money/api/v1/developer-fee' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "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

FieldDescription
developer_fee_percentYour conversion fee, as a percent. A decimal string with at most two decimals, greater than 0 and at most 10.
developer_fee_fixed_amountYour 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_percent never 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

StatusCodeWhen
400Neither field was sent, or a value is not a decimal string.
422INVALID_DEVELOPER_FEE_PERCENTThe percentage is 0 or above 10.
422INVALID_DEVELOPER_FEE_FIXED_AMOUNTThe fixed amount is 0 or above 50.
422DEVELOPER_FEE_REQUIREDThe change would leave no part of the developer fee in place.

Related: Developer fees in the Developer Platform guide.