--- title: "How to Create a Referral Program" id: "1248" type: "docs" slug: "createprogram" published_at: "2026-08-24T06:40:21+00:00" modified_at: "2026-08-26T02:22:39+00:00" url: "https://help-new-pro.partnershare.net/en/help/started/createprogram" markdown_url: "https://help-new-pro.partnershare.net/en/help/started/createprogram.md" excerpt: "1. Create a product Go to the brand owner admin dashboard and click “Create your first product.” 2. Set up the product 2.1 Complete basic configuration Upload the product logo, name, industry, etc., then move to the next step: 2.2..." taxonomy_doc_category: - "Getting Started" --- ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPJyGF1y8mfltQULD6hr47Eio3cwlDF3jyDucB_80_80-1.png) ## Getting Started 4 - [How to Launch Your Affiliate Program on PartnerShare](https://help-new-pro.partnershare.net/en/help/started/ipe) - [How to Create a Referral Program](https://help-new-pro.partnershare.net/en/help/started/createprogram) - [What Is Referral Marketing / “Old-Bring-New” Program](https://help-new-pro.partnershare.net/en/help/started/rmp) - [What is Affiliate Marketing?](https://help-new-pro.partnershare.net/en/help/started/marketing) ![合作伙伴管理 - PartnerShare](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPKHuo_8Hse9tQULBcxdOVHL3PdwlDF3jyDucC_80_80.png) ## Campaign Operations 5 - [Checking Partner Withdrawal Status](https://help-new-pro.partnershare.net/en/help/operations/withdrawal-2) - [Withdrawal Methods Supported for Partners](https://help-new-pro.partnershare.net/en/help/operations/wm) - [Affiliate Management](https://help-new-pro.partnershare.net/en/help/operations/promoter) - [Product Management](https://help-new-pro.partnershare.net/en/help/operations/product-management) - [Campaign Management](https://help-new-pro.partnershare.net/en/help/operations/campaign) ![支付与交易 - ParterShare](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPJwyP0mL5vltQULAn8_2d-Nx0hglDF3jyZ0QA_80_80.png) ## Payments&Transactions 2 - [Auto-Payout](https://help-new-pro.partnershare.net/en/help/payments/autopayout) - [Commission Settlement](https://help-new-pro.partnershare.net/en/help/payments/settlement) ![技术集成 - PartnerShare](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPJwDplrTBzltQULCNPWCeBswcaAlDF3jyZ0QB_80_80.png) ## Account Management 2 - [Business Certification Prompts](https://help-new-pro.partnershare.net/en/help/account/bcp) - [Team Management](https://help-new-pro.partnershare.net/en/help/account/team) ![技术集成 - PartnerShare](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPJwDplrTBzltQULCNPWCeBswcaAlDF3jyZ0QB_80_80.png) ## Technical Integration 5 - [Embedding PartnerShare into Your Product](https://help-new-pro.partnershare.net/en/help/technical/embedding) - [Conversion Event Postback](https://help-new-pro.partnershare.net/en/help/technical/event) - [Click-Tracking SDK Integration](https://help-new-pro.partnershare.net/en/help/technical/sdk2) - [API Authentication & Signature Mechanism](https://help-new-pro.partnershare.net/en/help/technical/api) - [PartnerShare Product-Authorized Login Integration Guide](https://help-new-pro.partnershare.net/en/help/technical/guide) ![常见问题 - PartnerShare](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPJwbpuanIXltQULBfzi8WsAsVUQlDF3jyDucA_80_80.png) ## Frequently Asked Questions 2 - [Withdrawal FAQ](https://help-new-pro.partnershare.net/en/help/faqen/faq) - [Legacy Help Center Entrance](https://help-new-pro.partnershare.net/en/help/faqen/legacyhelp) ![快速入门 - PartnerShare](https://help-new-pro.partnershare.net/wp-content/uploads/2026/01/lQLPJyGF1y8mfltQULD6hr47Eio3cwlDF3jyDucB_80_80.png) ## Changelog 2 - [Changelog – 2026.03.05](https://help-new-pro.partnershare.net/en/help/changelog/changelog-2026-03-05) - [Changelog – 2026.05.15](https://help-new-pro.partnershare.net/en/help/changelog/changelog-2026-05-15) View Categories ## **1. Create a product** Go to the brand owner admin dashboard and click “Create your first product.” ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/08/image-3-1024x578.png) ## **2. Set up the product** ### **2.1 Complete basic configuration** [#](#0-toc-title) Upload the product logo, name, industry, etc., then move to the next step: - **Logo:** Upload the product logo - **Product name:** Enter the product name - **Industry:** Select the product’s industry - **Settlement currency:** Currently USD only - **Theme color:** Choose a theme color — ideally matching your product for consistent embedding - **Official website:** Enter your official site - **Promotion URL:** The landing page visitors reach via the “referral link.” For example, if user A sees a dedicated referral link in the product like `https://www.partnershare.net/12345`, then `www.partnershare.net` is the promotion URL. - **Product description:** Enter a description ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/08/image-4-1024x578.png) ### **2.2 Set up reward rules** [#](#1-toc-title) Three reward types are currently supported: - **Signup reward:** The referrer earns a reward once the referred user signs up. - **Transaction share:** The referrer earns a reward once the referred user signs up and pays (e.g., purchase, top-up). - **Custom event:** Postback a custom event to enable personalized reward mechanics. ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/08/image-5-1024x847.png) ### **2.3 Set up tracking integration** [#](#2-toc-title) 1. Place the tracking snippet in the `
` of the HTML page used for promotion. It will automatically track visitors arriving via the referral link and report click events.These cookie values can later be used to track signup and payment events. - When a visitor opens your site via a referral link, the tracking script automatically reports a click event for your site. - It also automatically sets two cookies on your site: - `ps_click_id` (invited-user click ID): a unique visitor ID generated by an algorithm when the invited person clicks the referral link. - `ps_ref` (referral code): the referrer’s invite code. 2. Click the “verify code installation” button — we’ll check whether setup succeeded. ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/08/image-6-1024x769.png) ### **2.4 API integration** [#](#3-toc-title) Complete the data postback per the developer documentation. ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/08/image-7-1024x866.png) **Endpoint info** - Host: `https://api-service.partnershare.net/` - Path: `POST /api/open/v1/track/conversion` - Description: The brand’s system calls this endpoint to report conversion events (signup, payment, etc.) - Auth: API Key + API Secret + signature. [See how API authentication works](https://help-new-pro.partnershare.net/en/help/technical-integration/api-authentication-signature-mechanism) **Request parameters** *Attribution parameters (choose one)* | Parameter | Type | Required | Description | | --- | --- | --- | --- | | click_id | string | Conditionally required | The invited user’s click ID; PartnerShare links this ID to the specific promotion channel and partner | | invite_code | string | Conditionally required | The referrer’s invite code | Notes: - `click_id`: This is the `ps_click_id` obtained via - `invite_code`: This is the `ps_ref` obtained via the same step - Depending on the campaign, pass just one of these *Event type parameters (choose one)* | Parameter | Type | Required | Description | | --- | --- | --- | --- | | event_type | integer | Conditionally required | Event type: 1 = signup, 2 = payment, 3 = custom event | | event_name | string | Conditionally required | Event name: signup, purchase, or a custom name | Note: pass just one of these depending on the campaign. *User info parameters* | Parameter | Type | Required | Description | | --- | --- | --- | --- | | invited_user_id | string | Conditionally required | The invited user’s ID (in the brand’s own system) | | invited_user_name | string | No | The invited user’s display name | Notes: - For signup events: `invited_user_id` is required. - For payment/custom events: if `click_id` is provided, `invited_user_id` can be omitted — the system will sync user info from the signup event. *Transaction parameters (for payment events)* | Parameter | Type | Required | Description | | --- | --- | --- | --- | | transaction_id | string | No | Transaction ID (used for de-duplication and traceability) | | conversion_value | string/float | Conditionally required | Conversion value (order amount); required for percentage-based rewards | | currency | string | No | Currency code (default: USD) | | transaction_cycle_count | integer | No | Number of billing cycles (for installment rewards, e.g., 12) | Notes: - Required if the reward rule is percentage-based. - `transaction_id` is strongly recommended to prevent duplicate rewards. - `transaction_cycle_count` is used for installment rewards when a plan is set up for installments but no explicit count is configured. *Error codes* | Code | Description | | --- | --- | | 0 | Success | | 6000000 | Business error (see message for details) | | 401 | Auth failed (invalid API Key, wrong signature, expired timestamp, etc.) | | 403 | IP not on the whitelist | **3. Start promoting** Once testing passes, the referral program goes live. By embedding the referral page directly into your product or website, you can avoid external redirects and let promoters complete binding, invites, and cashback all on one page — lowering friction and improving conversion. [See how to embed PartnerShare into your product](https://help-new-pro.partnershare.net/en/help/technical-integration/embedding-partnershare-into-your-product) ![Image](https://help-new-pro.partnershare.net/wp-content/uploads/2026/08/image-8-1024x588.png) Updated on 26/08/2026 ###### Share This Article : - ![Image](https://help-new-pro.partnershare.net/wp-content/plugins/betterdocs/assets/images/social/share-icon.svg?v=4.3.4) - [https://www.facebook.com/sharer/sharer.php?u=https://help-new-pro.partnershare.net/en/help/started/createprogram](https://www.facebook.com/sharer/sharer.php?u=https://help-new-pro.partnershare.net/en/help/started/createprogram) - [https://twitter.com/intent/tweet?url=https://help-new-pro.partnershare.net/en/help/started/createprogram](https://twitter.com/intent/tweet?url=https://help-new-pro.partnershare.net/en/help/started/createprogram) - [https://www.linkedin.com/shareArticle?mini=true&url=https://help-new-pro.partnershare.net/en/help/started/createprogram](https://www.linkedin.com/shareArticle?mini=true&url=https://help-new-pro.partnershare.net/en/help/started/createprogram) - [https://pinterest.com/pin/create/button/?url=https://help-new-pro.partnershare.net/en/help/started/createprogram](https://pinterest.com/pin/create/button/?url=https://help-new-pro.partnershare.net/en/help/started/createprogram) [What Is Referral Marketing / “Old-Bring-New” Program](https://help-new-pro.partnershare.net/en/help/started/rmp) [How to Launch Your Affiliate Program on PartnerShare](https://help-new-pro.partnershare.net/en/help/started/ipe) 大纲 - [2.1 Complete basic configuration](#0-toc-title) - [2.2 Set up reward rules](#1-toc-title) - [2.3 Set up tracking integration](#2-toc-title) - [2.4 API integration](#3-toc-title)