Affiliate Admin

Set this affiliate's commission rate, in whole percent (spec 3.7).

<br/>The program default is 50 percent and a negotiated partner can carry any<br/>whole percent from 1 to 100. Anything else is 422 invalid_rate and<br/>writes nothing, and that is the ONLY refusal shape this route has: a<br/>fractional percent and a string both come back as {code, error} rather<br/>than as the validator's raw array (round 14 walkthrough, finding 7). The change is NEVER retroactive: every commission row<br/>stores the rate it was booked at, so this only reaches invoices that<br/>arrive from now on.<br/><br/>Every change appends an audit_log row naming this admin, the affiliate,<br/>and the old and new rate, the same treatment the payout-details reveal<br/>gets. The response is the updated queue row, so the drawer re-renders from<br/>the answer rather than re-reading.

put/api/v1/admin/affiliates/{affiliate_id}/rate

Request

  • Base URL: https://api.avatarfactory.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.avatarfactory.io/api/v1/admin/affiliates/{affiliate_id}/rate
  • Auth: one of:
    • API key in cookie session
    • HTTP bearer

Path parameters

affiliate_idinteger required

Request body

percentinteger

REQUIRED. A whole percent from 1 to 100. Omitting it, or sending a fraction, a string or a boolean, answers 422 invalid_rate.

Response

OK

applied_atstring date-time nullable
channelsstring[]
codestring required
code_renamedboolean required
commission_rate_bpsinteger required
decided_atstring date-time nullable
decided_by_user_idinteger nullable
decline_reasonstring nullable
emailstring required
full_namestring required
idinteger required
payout_detailsobject
payout_methodstring required
phonestring nullable
statusstring required
terms_accepted_atstring date-time nullable
terms_versionstring nullable
user_idinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.