Set a merchant's per-transaction commission rate (tenant admin)
The tenant's negotiated marketplace commission for this one merchant, applied to every catalog sale it makes.
/v1/clients/{clientId}/commissionThe tenant's negotiated marketplace commission for this one merchant, applied to every catalog sale it makes. It overrides the tenant's default commission rate; a per-offering rate still beats it. Requires fees:manage, the same authority as the tenant-wide fee plan; a merchant cannot set its own commission.
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Only the rate is negotiable; the flat part and band stay with the tenant plan.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X PUT "https://example.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/commission" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea", "org_alias": "string", "display_name": "string", "category": "string", "description": "string", "logo_url": "string", "commission_bps": 0, "status": "pending", "approved_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z"}Move the client's settlement money into its marketing account
Moves money from the client's settlement balance into its marketing account, where cashback rules draw from.
List this merchant's own cashback and loyalty rules
The merchant's own cashback and loyalty rules — the ones it owns, not the tenant-wide rules that may also apply to its sales.