Skip to main content
POST
Create commission adjustments
Requires commission-adjustments:write. See the commission adjustments guide for behavior and examples.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional retry key, unique within the selected program. Reuse the same key, method, path and validated payload; a conflicting reuse returns 409.

Required string length: 8 - 200
Pattern: ^[\x21-\x7e]+$
X-Program-Id
string

Select the key's original program or a program provisioned by this exact key. Other owned programs remain inaccessible.

Body

application/json
affiliateId
string
required
amount
number
required

Nonzero signed amount in major units, at most 6 decimals. Negative requires originalCommissionId.

Required range: -1000000000 <= x <= 1000000000
currency
string
required
Pattern: ^[A-Z]{3}$
reason
string
required
Required string length: 1 - 2000
sourceReference
string
required
Required string length: 1 - 200
originalCommissionId
integer
Required range: x >= 1

Response

Success. Monetary amounts use program currency; see companion documentation for resource fields.

Last modified on October 23, 2026