Affiliates

Credit a sale to a partner code and read what is owed.

Give partners a code, then credit each sale from your checkout. The commission is worked out from their rate and starts as waiting.

Credit a sale

bash

curl -X POST https://app.softsolz.uk/api/v1/services/affiliates/affiliates/commissions \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"code":"ADAREF","subject_type":"invoice","subject_id":"INV-1042","sale_amount_cents":50000}'

Safe to retry

The same subject_type and subject_id can never be credited twice. A repeat call returns already_recorded and leaves the original commission alone, so a retrying webhook cannot cost you money.

Read what is owed

bash

curl "https://app.softsolz.uk/api/v1/services/affiliates/affiliates/commissions?status=approved" \
  -H "Authorization: Bearer sk_live_your_key"

Paid is final

A commission moves waiting to approved to paid, and cannot skip a step. Once paid it cannot be reopened, edited or rejected, so the payout history cannot be rewritten.

Every field in the API Reference, and the walkthrough on docs.softsolz.uk.