Promotion
With promotions, plan so that a light click naturally leads to conversion. From driving repeat visits to creating natural virality, you can achieve results throughout the funnel.
What is a promotion
The promotions in App in Toss are events that give users Toss points based on specific actions. For example, benefits can be given based on actions such as signing up or completing the first use.
Promotions are run with the budget topped up in the Biz Wallet. You can also directly set in the console whether to display them in the Benefits tab.
When Toss points are issued through a promotion, a toast notification appears at the top of the user's screen.
(Mini app name) issued (amount) won It appears briefly in the format and then disappears automatically.
You can also check it 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 accumulated history in the Toss points menu under the Benefits tab.
In the Toss app, you can check the accumulation history by tapping Benefits → Toss points → point amount → mini app name.
Benefits of promotions
You can top up the Business Wallet in advance and set a budget and end date, so you can operate it without worrying about spending beyond the budget.
If it is exposed in the Toss Benefits tab, more users can come in along with higher traffic.
You can simply encourage user actions like signing up or starting the first play.
You can increase retention by creating reasons for users to return through daily and weekly missions.
Point issuance and result lookup can be handled via API.
Test code
TEST_{promotionCode}can be used to verify without deducting actual points.
Register a promotion in the console
To start a promotion, please prepare the items below first. If you're already done, you can skip straight to step 5 (registering the promotion).
Register business information and review settlement information (business review takes 1-2 business days, settlement review takes 2-3 days)
The representative manager's agreement to the promotion feature terms and the Business Wallet terms
Top up the promotion budget into the Business Wallet (minimum 300,000 won, maximum 30,000,000 won)
1. Register business information
Promotions can only be used in a business account (individual or corporation). If business registration is not complete, the console will show 'Please register your business information first.' Please click 'Register' to enter your business information.
Business information review about 1 to 2 business days may be required.
For details, please check Business Registration Guide.
2. Register settlement information
Once business registration is complete, the screen will change to 'Please register settlement information next.' Click the 'Register' button, register the settlement information in the Partner Information menu, and request a review.
Settlement information review takes an average of 2 to 3 business days .
You cannot request a review before registering settlement information. Please check the business registration status first.
3. Top up the Business Wallet
After settlement information review is complete, please agree to the promotion terms.
After that the widget at the top right of the Promotion menuor the 'Business Wallet' menu in the workspace can be used to top up the budget.
Amount that can be topped up: Minimum 50,000 won ~ maximum 30,000,000 won
Available payment methods now: credit card (authenticated payment, non-authenticated payment)
Authenticated payment: no payment limit by card company
Non-authenticated payment: Hana Card daily limit of 1,000,000 won, no limit for other card companies (non-authenticated payment is a method where you enter the card number directly.)
When the top-up is complete, the status changes to 'Top-up' and the topped-up amount is reflected.
Automatic top-up can also be configured. (e.g. if 100,000 won remains, top up by 500,000 won at a time)
Settlement and operation principles
The promotion budget is set after topping it up in the Business Wallet. When the budget is fully used up, the promotion ends.
If you stop the promotion, the remaining budget is returned to the Biz 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 record.
4. Register a promotion
When exposed in the Benefits tab
When not exposed in the Benefits tab
Promotion name: Please enter in detail what condition the user must meet to receive points. e.g. 10 points given when logging into the service, 20 points given when completing the tutorial
Promotion end date: Please set the desired end date. The promotion may end earlier than scheduled if the budget is exhausted.
Benefits tab exposure
Exposed: It appears together in the Toss app under Benefits → Try out a new service.
Not exposed: The promotion is provided only to users who access the mini app directly.
Caution: If you register as not exposed and later want it exposed, register a new promotionyou must. (It cannot be changed through editing.)
Mission name (required when exposed in the Benefits tab): The mission name must end with 'doing'. e.g. Tutorial, Log in, Leave a review
Payout method (required when exposed in the Benefits tab)
Fixed amount: Pays out a set amount.
Maximum amount: the maximum amount that can be paid per person. Rewards are paid out randomly within this range. e.g. maximum 100 won → when participating once, payout is between 0 and 100 won
Destination URL (required when exposed in the Benefits tab)
Format:
intoss://{{appName}}/ScreenNameEnter through this URL in the Benefits tab.
Budget information
The budget cannot be set higher than the Biz Wallet balance.
To increase the budget during operation, top up the Business Wallet and then increase it in Edit Promotion.
Maximum amount per person per day (required): Please set the maximum amount one person can receive per day.
The same user will not be paid more than this amount.
It helps prevent abuse and manage the budget stably.
If abuse is especially concerning, please make sure to set it. We also recommend applying it even when the client requests point issuance.
After entering the promotion information, please click [Request Review]. The review takes 2 to 3 business days .
Integrate development
issuing Toss points in game and non-game mini apps SDK function and server API integration methodscan be checked.
When explaining the promotion, please be sure to tell users the following information.
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 in case of withdrawal, refund, or fraudulent participation)
Include the phrase "This promotion may be stopped without prior notice"
Random payout not allowed (fixed payout only)
Start testing
Once the review is complete, please proceed with testing using 'Test'. No actual points will be deducted during testing.
The test promotion code is
TEST_prefixed to the actual code.When testing, points are not deducted and no actual payout is made.
When calling the point payout API
resultTypeisSUCCESSPlease check whether it is returned as.After the review is complete, you must complete the point payout API test at least once before you can start the promotion.
Start and operate the promotion
Press the 'Start' button to begin the promotion.
The budget column is
actual spent amount / total budgetshown in this format, so you can check how much of the budget has been spent.Promotion editing 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 shown in the Benefits tab. Please manage the budget regularly.
By clicking the campaign name, you can view detailed promotion information and edit, end, or pause it.
Edit: Mainly used when increasing the budget. To increase the budget, please proceed in the following order: Campaign details → Edit promotion button → enter amount to increase → save. If you want to change settings other than the budget, there may be restrictions due to internal policy, so please check the review guidelines first.
End: When the promotion ends, the remaining budget is automatically refunded to the Business Wallet. The refunded amount is often reflected immediately after the end, but it may be delayed a little due to system processing. Please check the budget often so the promotion does not end automatically due to budget exhaustion.
Check performance
Once the promotion starts, you can check its performance in the dashboard. The dashboard shows at a glance how effective the promotion was and helps improve the next campaign strategy.
Promotions not exposed in the Benefits tab are not shown in the performance dashboard.
Period settings and query conditions
Performance data can be queried by various criteria. It's good to change the conditions depending on your analysis purpose.
Daily, weekly, monthly data can be queried.
By operating system (OS)Performance can be checked separately.
You can query both all promotions currently running in the mini app and individual promotions separately.
In the promotion performance dashboard, you can check the flow of users participating in the promotion step by step. Looking at this flow, you can final conversion rateand identify at which step users drop off the most.
Entering the Benefits tab: This promotion is shown in the Benefits tab of the Toss app, and this is the number of users who saw it.
Promotion click: This is the number of users who actually clicked the promotion in the Benefits tab and entered the detail screen. Comparing this with Benefits tab entries shows how much the promotion title or thumbnail attracted user interest.
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 also check performance by dividing the users brought in by the promotion according to their characteristics.
New users: Users who entered the mini app for the first time because of the promotion.
Existing users: Users who have used the mini app before.
You can also check how much the promotion contributed to actual revenue. However, contributed revenue can only be queried by workspace (business number) and not by mini app.
Total contributed revenue: The total revenue generated by users brought in through the promotion.
Average revenue per payer: Among users brought in through the promotion, only users who actually made paymentsis the average revenue calculated based on them.
Average revenue per user overall: regardless of whether they paid or not, all users brought in through the promotionis the average revenue calculated based on them.