> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/en/marketing/promotion.md). # Promotion With promotions, plan so that a light click naturally leads to conversion. From encouraging repeat visits to creating natural virality, you can drive results throughout the funnel. ### What is a promotion Promotions in Apps in Toss are events that award Toss Points based on specific user actions. For example, you can offer benefits based on actions such as signing up or completing the first use. Promotions are operated using the budget topped up in the Business Wallet. You can also set directly in the console whether to display them in the Benefits tab.
Allowed promotion types * Signup/access rewards (e.g., 2,000 points for new signups) * Transaction/purchase incentive type (the conditions and guidance must be clear. e.g., 500 points for payments of 5,000 won or more) * However, Toss Points that have already been awarded cannot be reclaimed. Please review the promotion conditions and payout criteria thoroughly and operate it carefully. * Event participation type (surveys, quizzes, simple missions. However, it cannot require too much time or labor.) * Friend invitation type (both the inviter and the invitee are rewarded. Anti-abuse logic required) * Probability-based/random rewards for non-game apps * Promotion periods can only be operated for up to one week. * It can only be used for promotional purposes to attract new users. * Even if it is registered as a non-game app, if it is classified as a game, you cannot run a probability-based promotion.
Promotion Not allowed Type * Probability-based/random rewards for game apps (roulette, lottery, etc.) * Rewards based on game results (score, win/loss, ranking) * Reward type that exchanges goods for currency (converting gifticons or gift cards into Toss Points) * Cash-guaranteed or quasi-deposit activities (investment-like or gambling-like nature) * Payouts exceeding 5,000 points per person (lottery-based items require separate review)
{% hint style="info" %} **Please note** The promotion feature can be used without a separate server. Non-game mini apps can also use a Server-to-Server method to award promotion points through a server. If integrity is important, such as preventing request tampering, please use the server-based payout method. The promotion feature can be used without a separate server. To award promotions through a server, you need to implement Toss Login. [Toss Login Guide](/guide/en/authentication/intro.md)Please refer to it. {% endhint %} When Toss Points are awarded through a promotion, a toast notification appears at the top of the user screen. * **(Mini app name) awarded (amount) won** It appears briefly in the form of * and can also be checked in the Toss app's notification menu (the bell button on the home screen). * However, depending on the user's notification settings, it may not appear in the notification menu. * You can also check the accrual history in the Toss Points menu on the Benefits tab. * In the Toss app, you can check the accrual history by tapping Benefits → Toss Points → point amount → mini app name.
*** ### Benefits of promotions * By preloading the Business Wallet and setting a budget and end date in advance, you can run promotions without worrying about overspending. * If displayed on the Toss Benefits tab, more users can come in with higher traffic. * You can easily encourage user actions such as signing up or starting the first play. * You can create a reason for users to return with daily and weekly missions, helping increase retention. * Point payouts and result lookups can be handled via API. * Test code `TEST_{promotionCode}`Use it to verify without deducting actual points. {% hint style="info" %} **Please note** * The 'Try a New Service' tab, which displays multiple promotions from Apps in Toss together, may be shown only to some users depending on the internal exposure logic. * Promotions cannot be run with gambling content, content that encourages installing our own app, or content that may violate laws. * Please be sure to apply one-person-one-time limits, daily limits, cooldowns, and duplicate payout prevention logic. * If payout is delayed, please provide guidance for PENDING status and a path to check the result. * Pre-review is required to start a promotion. The review takes about 2-3 business days. {% endhint %} *** ### Register a promotion in the console To start a promotion, please prepare the following items first. If you have already finished preparing, you can go straight to promotion registration. * Register business information and review settlement information (business review takes 1-2 business days, settlement review takes 2-3 days) * The representative administrator's agreement to the promotion feature terms and the Business Wallet terms * Top up the Business Wallet with promotion budget (minimum 50,000 won, maximum 300 million won) #### 1. Register business information Promotions can only be used in business (individual or corporate) accounts. If you are not registered as a business, the console will show the screen 'Please register your business information first.' Please tap 'Register' to enter your business information. * Business information review can take **about 1-2 business days** . * For detailed procedures, [Business Registration Guide](https://developers-apps-in-toss.toss.im/guide/operation/register-business)please check.
#### 2. Register settlement information Once business registration is complete, the screen will change to 'Next, please register settlement information.' Tap the 'Register' button, register settlement information in the partner information menu, and request review. * Settlement information review **takes an average of 2-3 business days** . * You cannot request review before registering settlement information. Please check the business registration status first.
{% hint style="info" %} **Notes when registering settlement information** * The account holder name should match the bankbook copy **exactly** . * For business type and industry, search by entering **text**instead of a numeric code. Example: search 'software' for 'software development'. {% endhint %} #### 3. Top up the Business Wallet After the settlement information review is complete, please agree to the promotion terms. After that, **the widget at the top right of the Promotion menu**or the 'Business Wallet' menu in the workspace can be used to top up the budget.
* Amount available for top-up: **Minimum 50,000 won \~ maximum 300,000,000 won** * Available payment methods now: credit card (authenticated payment, unauthenticated payment) * Authenticated payment: no card-company-specific payment limits * Unauthenticated payment: Hana Card limited to 1,000,000 won per day, no limits for other card companies (unauthenticated payment is a method where you enter the card number directly.) Once the top-up is complete, the status changes to 'Top up,' and the topped-up amount is reflected. You can also set up auto top-up together. (e.g., top up 500,000 won when 100,000 won remains) **Settlement and operation principles** * Promotion budgets are set after topping up from the Business Wallet. When the budget is fully used, the promotion ends. * If you stop the promotion, the remaining budget is returned to the Business Wallet. (if there is a balance) * Duplicate participation and anti-abuse logic must be applied. * If a claim arises, the partner company must handle it after checking the participation records. #### 4. Register a promotion **Browse a mini app and get points** This is a promotion where users can receive points just by browsing a mini app for 10 seconds. It can be operated immediately through console settings without separate development, and both game and non-game mini apps can participate.
From September 21, a fixed entry point called 'Choose a Mini App That Matches My Taste' will appear for this promotion in the Benefits tab's 'Various Benefit Missions.' When users click the entry point, they are moved to the full tab, shown two mini apps to choose from, and can receive points by browsing a mini app for 10 seconds.\nHowever, only released mini apps can use this promotion. * Path: Apps in Toss console → Representative admin login → Select workspace → Select mini app → Left menu Promotion → 'Browse a mini app and get points' button
1. **Points awarded** — 10 won are awarded if the user browses the mini app for 10 seconds. Browsing time (10 seconds) is fixed. 2. **Number of participations** — You can set it so that one person can participate up to N times (e.g., 2 times). The waiting time before re-participation is fixed at 1 hour. 3. **Campaign period** — You can set the promotion period yourself. 4. **Budget** — Payouts are made only within the partner company's budget limit, and if the limit is exceeded, payouts stop and exposure also stops. After entering the promotion details, please click 'Apply.' After applying, approval takes about 2 business days (D+2). {% hint style="info" %} Please be sure to check * If the budget is insufficient, exposure may suddenly stop midway through the campaign. We recommend setting a generous budget considering the target operating period and expected number of participants. * If a user meets the payout conditions but is not paid, Toss may pay first and settle later. {% endhint %} **Complete missions and get points** **When displayed on the Benefits tab**
**When not displayed on the Benefits tab**
* **Promotion name:** Please enter in detail what conditions a user must meet to receive points. e.g., 10 points for service login, 20 points for completing the tutorial * **Promotion end date:** Please set the desired end date. It may end earlier than scheduled if the budget runs out. * **Benefits tab display status** * Displayed: In the Toss app, it appears together under Benefits → Try a New Service menu. * Not displayed: The promotion is provided only to users who access the mini app directly. * Caution: If you register it as not displayed and later want to display it, **register a new promotion**you must. (You cannot change it by editing.) * **Mission name** (Required when displayed on the Benefits tab): The mission name must end with '\~하기' ('do'). e.g., complete the tutorial, log in, leave a review * **Payout method** (Required when displayed on the Benefits tab) * Fixed amount: Pay a fixed amount. * Maximum amount: The maximum amount that can be paid per person. A random amount is paid within this range. e.g., maximum 100 won → pay between 0 and 100 won per participation * **Destination URL** (Required when displayed on the Benefits tab) * Format: `intoss://{{appName}}/ScreenName` * Users come in through this URL from the Benefits tab. * **Budget information** * The budget cannot be set higher than the Business Wallet balance. * If you want to increase the budget during the campaign, you can top up the Business Wallet and then increase it in Edit Promotion. * **Maximum payout per person per day** (Required): Please set the maximum amount one person can receive per day. * We do not pay more than this amount to the same user. * It helps prevent abuse and manage the budget stably. * Please set it especially if you are worried about abuse. We recommend applying it even when the client requests the point payout. #### What are proprietary points? Promotions that issue proprietary points are subject to separate management policies upon registration. Proprietary points refer to points used in promotions where points or assets (honey, hearts, diamonds, coins, etc.) issued by the mini app itself are accumulated for users and then converted into Toss Points. {% hint style="info" %} **Please be sure to check** Proprietary points can be considered to have monetary value that can be used to purchase goods or services from a third party and pay consideration at the moment they are converted into Toss Points. Apps in Toss aims to comply with the Electronic Financial Transactions Act and implement the following measures to ensure the safety and reliability of proprietary-point promotions. {% endhint %} **How to register proprietary points** When creating a promotion, you can register whether it uses proprietary points. * First, the system automatically identifies whether it uses proprietary points based on the promotion details. * If the system does not identify it, you can also set whether it uses proprietary points manually. * If it is identified as a proprietary-point promotion, we will notify you by email, and you can also check it in the detailed information for each promotion. **Compliance requirements** To operate a proprietary-point promotion, you must comply with the following. **Monthly budget limit** * The monthly total of all promotion budgets, including proprietary-point promotions, cannot exceed 100 million won. **Monthly reporting obligation** * At the end of each month, you must enter the total amount issued, unit, and Toss Points conversion ratio for proprietary points in the console.
**Restriction on use of promotion codes** * After promotion approval, the issued promotion code must be operated only according to the content written in the application form. Using that code for another promotion is strictly prohibited. **What happens if you do not comply with the management obligations?** Apps in Toss detects proprietary points that are operated without prior approval. * Operating unapproved proprietary points * Failing to comply with and deferring the obligation to enter the issuance amount * Using the promotion code for a promotion different from the approved content If any of the above are confirmed, the promotion may end without notice. After entering the promotion details, please click \[Request Review]. Review takes **2-3 business days** .
Pre-checklist for promotions You can proceed with the promotion only after satisfying all the items below. □ The points being paid are **5,000 points or less per person**Is it?\n□ Have you clearly explained the payout conditions, payout timing, and payout restrictions?\n□ Is the participation method simple and does it not require much time or labor?\n□ (For games) Is it not combined with probability-based elements such as roulette or lottery?\n□ Are the points awarded not determined by game results or ranking?\n□ Is it not a form that exchanges or converts the user's assets into Toss Points?\n□ Have you informed users in advance that the promotion may end early or be suspended?\n□ Have you applied duplicate participation prevention logic?\n□ Is it not a promotion with gambling characteristics or exaggerated claims?
*** ### Connect development Awarding Toss Points in game and non-game mini apps [How to integrate SDK functions and server APIs](https://developers-apps-in-toss.toss.im/documentation/common/growth/promotion#undefined-5)You can check it. When explaining the promotion, be sure to tell users the information below. * Payout timing (e.g., immediate payout, payout at 6 PM the next day, etc.) * Payout conditions (e.g., first payment, payment of 5,000 won or more, etc.) * Payout restrictions (no payout if the user withdraws, gets a refund, or participates fraudulently) * Include the phrase, "This promotion may be suspended without prior notice." * Random payouts not allowed (fixed payouts only) *** ### Run test After the review is complete, please proceed with testing using 'Test it.' No actual points are deducted during testing. * The test promotion code has `TEST_`prefixed to the real code. * During testing, points are not deducted and no actual payout is made. * When calling the point payout API `resultType`is `SUCCESS`Please check that it is returned. * After the review is complete, you must complete at least one point payout API test before you can start the promotion.
*** ### Start and operate the promotion Press the 'Start' button to begin the promotion. * The budget column is `actual spend amount / total budget` displayed in this format, so you can check how much budget has been used. * Editing a promotion is mainly used when increasing the budget. * When the promotion ends, the remaining budget is refunded to the Business Wallet. * If the budget is exhausted, it will no longer be displayed on the Benefits tab. Please manage the budget regularly.
If you click the campaign name, you can check promotion details and edit, end, or pause it. * **Edit:** This is mainly used when increasing the budget. To increase the budget, please go through Campaign Details → Edit Promotion button → enter the amount to increase → Save. If you want to change settings other than the budget, there may be internal policy restrictions, so please check the review guidelines first. * **End:** When the promotion ends, the remaining budget is automatically refunded to the Business Wallet. Refund amounts are often reflected immediately after ending, but may be delayed slightly due to system processing. Please check the budget frequently so the promotion does not end automatically because the budget is exhausted. *** ### Check performance Once the promotion starts, you can check its performance on the dashboard. The dashboard shows at a glance how effective the promotion was and helps improve your next campaign strategy. **Promotions not displayed on the Benefits tab do not appear in the performance dashboard.** #### **Period settings and query conditions** Performance data can be queried by various criteria. It's good to review it while changing conditions to suit your analysis purpose. * **Daily, weekly, and monthly** You can query data by unit. * **By operating system (OS)**You can check performance separately. * You can query by distinguishing between all promotions currently operating in the mini app and individual promotions.
On the promotion performance dashboard, you can check the flow of users participating in the promotion step by step. By looking at this flow, **the final conversion rate**can be identified, and you can also see at which stage users are dropping off the most. 1. **Entering the Benefits tab:** This is the number of users who saw this promotion displayed in the Benefits tab of the Toss app. 2. **Promotion click:** This is the number of users who actually clicked the promotion in the Benefits tab and entered the detail screen. Comparing clicks to Benefits tab entries helps you see how much the promotion title or thumbnail attracted users' attention. 3. **Points earned:** This is the number of users who met the promotion conditions and actually received Toss Points. If the conditions are difficult or the process is complex, many users may drop off at this stage.
You can check performance by dividing users brought in through the promotion by type. * **New users:** Users who entered the mini app for the first time through the promotion. * **Existing users:** Users who have used the mini app before.
You can also check how much the promotion actually contributed to sales. However, contributed sales can only be queried by workspace (business number) and not by mini app. * **Total contributed sales:** The total sales generated by users brought in through the promotion. * **Average sales per person based on purchasers:** Among users brought in through the promotion, **only users who actually made a payment**are used to calculate the average sales. * **Average sales per person based on all users:** regardless of whether they made a payment, **all users brought in through the promotion**are used to calculate the average sales. *** ### Frequently Asked Questions
Do all promotions have a 5,000-point limit per person? Yes, that's right. For signups, transactions, events, friend invitations, and more, **all promotion types can, in principle, pay only up to less than 5,000 points per person** .
Are lottery or random payout events allowed? (For game apps) No. Probability-based, roulette, and random draw methods **carry the risk**of being interpreted as gambling and are not allowed. **Only fixed payouts**are allowed. (e.g., "500 points for first signup")
Can points be awarded based on in-game score/win-loss/ranking? No. According to relevant laws and regulations, directly linking game results to cash-like rewards is **an inducement to gambling**and is prohibited. For game apps, **only conditions unrelated to game results**(signup, login, tutorial completion, etc.) can be used for promotion operations.
Can gifticons or gift cards be exchanged for Toss Points? No. Rewards that exchange user-held assets are not allowed due to concerns such as money laundering. Toss Points payouts must be operated based on specific in-app actions (signup, payment, event participation, etc.).
How should the point payout timing be set? Decide the actual payout timing on your own, but you must **notify users in advance before they participate in the promotion**. e.g., 'Pay immediately after event participation' / 'Pay by 6 PM the next day,' etc.
Can the promotion be stopped midway? Except for reasons such as exceeding the budget, stopping the promotion is not recommended. In particular, if points are awarded only after a specific action is completed, users may not realize the promotion has ended. When running a promotion, **be sure to include the phrase** "This promotion may be suspended without prior notice".
How should friend invitation rewards be designed? It must be possible to provide the same reward to both the inviter and the invitee.**Duplicate participation and anti-abuse prevention logic**must be applied. The reward limit of up to 5,000 points per person applies equally.
Can cash be paid instead of points? No. Cash payouts or "deposit +N% guaranteed" structures **may constitute quasi-deposit or gambling-like activities**and may violate the law. It must **be paid only in the form of** Toss Points.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developers-apps-in-toss.toss.im/guide/en/marketing/promotion.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.