affiliate

POST /v1/affiliate

Join the affiliate programme.

Ҳамаи нуқтаҳои ниҳоии affiliate

Санҷиши ҳаққоният

Kalitи API-ро ҳамчун token-и bearer фиристед. Ин нуқтаи ниҳоӣ дар мушаххасот иҷозати мушаххасеро нишон намедиҳад, бинобар ин ба калиди худ ҳадди ақали заруриро диҳед ва ба ҷои тахмин кардан, ҷавобро санҷед.

Ҷое, ки рақами мушаххаси ташкилоти шумо ҷойгир аст

Ин нуқтаи поёнӣ org_id-ро ҳамчун параметри дархостӣ қабул мекунад. Онро хориҷ кунед ва даъват тамоми зердарахти иҷораи шуморо фаро мегирад; барои маҳдуд кардани даъват ба як созмон онро фиристед.

Rakami муайянкунандаи ташкилоти шумо дар экрани калидҳои API дар панели идоракунии шумо, дар паҳлӯи худи калид ҷойгир аст. Ин як раками муайянкунанда дар ҳар یک дархосте, ки шумо иҷро мекунед, якхела аст.

Санҷидан

Ҳар чизро дар қаavски кунҷӣ бо қиматҳои худ ва ҷойи нигоҳдорандаи калидро бо калима аз панели идоракунии худ иваз кунед.

curl -X POST https://api.zinndigital.com/v1/affiliate \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "commission_plan": <string<recurring_12m, lifetime>>, "payout_destination": <string<wallet, cash>>, "accept_terms": <boolean> }'

Воarid шудаед? Консоли API дар панели идоракунии шумо рақами мушаххаси ташкилоти воқеӣ ва калиди худро пур мекунад ва дархостро бар зидди API-и фаъол иҷро мекунад, то шумо посухи воқеиро бубинед. Ин нуқтаи ниҳоиро дар консоли API кушоед

Тафсилот

Gated on `affiliate.manage`. The account lands `pending` and accrues nothing until staff approve it — otherwise the programme is an open invitation to self-refer at scale. Choosing cash payouts sets `kyc_state` to `required`; wallet credit needs no verification because the money never leaves the platform.

Параметрҳо

НомНамудТалаб карда мешавадИн чӣ аст
org_id (query)stringНе

Ҷисми дархост

НомНамудТалаб карда мешавадИн чӣ аст
commission_planstring<recurring_12m, lifetime>Бале
payout_destinationstring<wallet, cash>Бале
accept_termsbooleanБалеMust be `true`. An affiliate agreement is a contract about money, so acceptance is recorded explicitly rather than assumed.

Ҷавоб

НомНамудТалаб карда мешавадИн чӣ аст
idstringБале
org_idstringБале
statestring<pending, approved, rejected, suspended>Бале
codestringБалеThe referral code. Its alphabet excludes the characters people transcribe wrongly (`0`/`O`, `1`/`I`/`l`), because it is read aloud and typed off a slide.
referral_urlstringБалеThe link to share — the public site with `?ref=CODE`.
commission_planstring<recurring_12m, lifetime>БалеThe line **new** referrals will be created on. Changing it never affects customers already referred.
payout_destinationstring<wallet, cash>Бале
kyc_statestring<not_required, required, submitted, verified, rejected>Бале
review_notestringНе
terms_accepted_atstringНе
applied_atstringНе

Хатоҳое, ки ин нуқтаи ниҳоӣ метавонад баргардонад

401 · 403 · 409 · 422