referral-program
/referral-program
Obsługuje program poleceń projektu: linki i kody afiliacyjne, dni członkostwa, prowizje, zatwierdzanie partnerów, księgę nagród i wypłaty.
- Autor
- envigoinnovations ↗
- Repozytorium
- subscriby-agentic-kit ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 3
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Obsługuje program poleceń projektu: linki i kody afiliacyjne, dni członkostwa, prowizje, zatwierdzanie partnerów, księgę nagród i wypłaty.
Oryginalny opis (EN)
This skill should be used when the user asks about a project's Referral Program, affiliates, referral codes or links, free membership days or cash commissions for members who bring friends, approving or suspending an affiliate, the reward ledger, or recording a payout to an affiliate.
Jak działa
- The programme
- How a referral is counted
- Affiliates and the ledger
- Do not
- References
Podgląd SKILL.md
---
name: referral-program
description: "This skill should be used when the user asks about a project's Referral Program, affiliates, referral codes or links, free membership days or cash commissions for members who bring friends, approving or suspending an affiliate, the reward ledger, or recording a payout to an affiliate."
license: MIT
metadata:
category: creators
catalogue: 2026-05-01
---
# The Referral Program
A project's one programme turns members into affiliates: each who joins gets a code and a link, a friend who arrives through them is theirs for thirty days, and when the friend's first payment settles the affiliate earns what the creator promised. Subscriby tracks every touch, quotes every reward when the payment lands, holds cash commissions through the refund window, reverses them on a refund, and keeps the ledger the creator pays from. Bundled with the Growth Plan; on Free and Starter through the Referral Program Addon. It is not the Partner Program, where a creator refers creators to Subscriby and Subscriby pays (`account-and-billing`).
## The programme
`get_referral_program` reads it; `update_referral_program` creates it on the first call and later changes only the arguments present:
- `reward_kind`: free membership days (`reward_days`, banked on the affiliate's own membership, waiting on their balance if they hold none) or a cash commission (`commission_type` percentage or fixed, `commission_value`, `commission_currency_id`; a percentage can run for the first payment only, a number of `commission_period_months`, or for life; a fixed amount earns on the first payment only).
- `friend_reward_kind`: nothing, free days (`friend_reward_days`) or one of the project's coupons applied at the friend's checkout (`friend_coupon_id`; needs coupon codes on the plan).
- `hold_days` (default 14) before a commission is payable; `customers_only` (only members with a live membership may join); `approval_required`; `minimum_payout` (a guide for the creator, shown to nobody); `terms` and `payout_details_label` (the question affiliates answer so they can be paid, such as a PayPal email); `plan_ids` (conversions outside the list earn nothing); `active`.
`activate_referral_program` and `deactivate_referral_program` switch it (a pause stops links counting and payments earning at once, keeps the ledger readable, tells every affiliate; switching back on tells them the terms as they stand); `delete_referral_program` is refused while any affiliate is owed a commission. Rewards never change after they are written; a change applies to payments that settle afterwards.
## How a referral is counted
A friend arrives through the affiliate's portal link, their bot link, or by typing the code where the checkout asks for a coupon; they are counted for thirty days, the first affiliate to touch them keeps them, an existing payer cannot be referred, and an affiliate cannot refer themselves. The reward is earned when the first payment settles: days are banked at once; a commission is written `pending`, becomes `payable` when the hold passes, is `reversed` by a refund inside the hold, and a refund after a payout writes a clawback the next payout nets.
## Affiliates and the ledger
- `list_referral_affiliates` (`status`, `member_id`), `get_referral_affiliate` (the one read with the per-currency balances: earned, payable, paid), `add_referral_affiliate` by `member_id` (approved whatever the switches say), `approve_referral_affiliate`, `suspend_referral_affiliate` (their code stops counting; what they earned stays payable).
- `list_referrals` (`status`, `affiliate_id`, `since`), `get_referral`, `list_referral_rewards` (`affiliate_id`, `status`, `beneficiary`) for the friends and the ledger.
- `list_referral_payouts` and `record_referral_payout` (`affiliate_id`, `amount`, `currency_id`, `reference`, `note`): a payout **records money that already left** the creator's hands, marks the oldest payable commissions in that currency as paid up to the amount, and tells the affiliate; it is refused above the payable balance, so read `get_referral_affiliate` first. An affiliate's own payout details (the wallet or email they typed) never travel over the tools or the webhooks; the creator reads them on the dashboard.
## Do not
- Do not record a payout the creator has not made, and never above the balance read first.
- Do not promise a reward on a renewal unless the programme's commission runs over a period or for life.
- Do not confuse it with the Partner Program or with coupons.
## References
- [references/tools.md](references/tools.md): the fifteen tools with their arguments.
- [references/events.md](references/events.md): the ten `referral.*` events (programme updated, affiliate joined, approved, suspended, captured, converted, reward earned, approved, reversed, payout recorded).
- [references/endpoints.md](references/endpoints.md): the REST twins under `/v1/projects/{project}/referral-program`, `/referral-affiliates`, `/referrals`, `/referral-rewards` and `/referral-payouts`.
- Documentation: [Referral Program](https://docs.subscriby.net/creators/referral-program), [the addon](https://docs.subscriby.net/addons/referral-program), [refer a friend, the member's side](https://docs.subscriby.net/subscribers/refer-a-friend).
Pliki w paczce (4)
- SKILL.md 5 KB
- references/endpoints.md 23 KB
- references/events.md 18 KB
- references/tools.md 20 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · envigoinnovations/subscriby-agentic-kit | 90 | MIT |
| TerminalSkills/skills | 100 | Apache-2.0 |
| 420company/artemis | 100 | MIT |
| alirezarezvani/claude-skills | 100 | MIT |
| The-Utopia-Studio/skills | 100 | Apache-2.0 |
| MoizIbnYousaf/marketing-cli | 100 | MIT |
| OpenClaudia/openclaudia-skills | 100 | MIT |
| mkurman/zorai | 100 | MIT |
| varunk130/ai-gtm-skill-library | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 86a7a9a9b6b7 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100affiliate-referral-program-stinger
Projektuje programy afiliacyjne i poleceń dla SaaS: wybór platformy, atrybucja, prowizje, nadużycia i ekonomika programu. - 90ambassly-affiliate-program
Prowadzi program afiliacyjny na Stripe przez MCP Ambassly: zaprasza partnerów, tworzy linki polecające, sprawdza prowizje i przygotowuje paczki wypłat. - 100affiliate-marketing
Buduje i prowadzi program afiliacyjny: partnerzy, prowizje za polecenia, sieć afiliacyjna, śledzenie i rozwój programu partnerskiego. - 85affiliate-page-generator
Tworzy, optymalizuje lub audytuje stronę programu partnerskiego: prowizje, zapis partnera i stronę lądowania. - 100referrals
Pomaga tworzyć, optymalizować i analizować programy poleceń, afiliacyjne i marketing szeptany, aby obecni użytkownicy i partnerzy przyprowadzali nowych klientów. - 100referrals
Pomaga tworzyć, optymalizować i analizować programy poleceń, afiliacyjne i marketing szeptany, aby obecni użytkownicy i partnerzy przyprowadzali nowych klientów.