Skip to main content
PUT
Set a customer's developer fee

What this endpoint does

Replaces your global developer fee for this customer only. The override never adds to your global fee. Omit transfer (send {}) to charge this customer no developer fee.

When to use it

Use it when one customer should pay a different flat or basis-point developer fee, or none, than your global schedule.

Before you call

Requires a secret API key plus a recent second-factor (MFA) confirmation from the signed-in user — a request authenticated only with an API key is refused with 403 step_up_required. In practice, change the override from a console session. Pass a customer ID owned by the same tenant account; a customer that belongs to another account returns 404.

Money and balance effect

This does not debit a wallet immediately. The override affects this customer’s conversions struck after the change. The same caps as your global developer fee apply; an over-cap fee is rejected with 422 and nothing is saved.

States and completion

A successful response confirms the saved override. In-flight transfers keep the fee captured for them.

Safe retries

Send a unique Idempotency-Key for the logical action. If the response is lost, retry the same payload with the same key; never create a new key merely because the first response timed out. Read Developer settings for the complete workflow.

Authorizations

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Headers

Idempotency-Key
string
required

A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response.

Required string length: 8 - 255

Path Parameters

id
string
required

Body

application/json
transfer
object

Response

The customer's updated developer fee override.

customerId
string
required
Minimum string length: 1
override
object | null
required