프로모션 (토스 포인트)
프로모션을 개발하기 전에 꼭 확인해 주세요.
- 사용자의 오인지를 방지하기 위해 토스에서 이미 사용 중인 명칭과 동일하게 사용하거나 다른 의미로 사용하는 것은 불가해요.
[예시]
- 포인트
- 미니앱 내에서 통용되는 자체 리워드에는 ‘포인트’ 라는 명칭을 사용할 수 없어요.
- ‘토스 포인트’가 지급된 것으로 오인할 수 있어요.
- ‘토스 포인트’와 명확하게 구분할 수 있는 용어로 사용해 주세요.
- 미니앱 내에서 통용되는 자체 리워드에는 ‘포인트’ 라는 명칭을 사용할 수 없어요.
- 출금, 인출 등 - 현금화하는 것으로 오인할 수 있는 용어는 사용할 수 없어요. - 미니앱 내에서 가상 자산이 ‘토스 포인트’로 전환되는 경우라면 ‘토스 포인트 지급’ 으로 표기해 주세요.
호출 제한
userKey별로 분당 최대 10회까지 호출할 수 있어요. 초과 시 에러가 반환돼요.
게임
별도의 서버 연동 없이도 게임 미니앱 내에서 유저에게 토스 포인트를 지급하고, 혜택탭에 프로모션을 노출하여 트래픽을 키울 수 있어요.
주의하세요
grantPromotionRewardForGame함수를 중복 호출하면 동일한 유저에게 리워드가 중복 지급될 수 있으니, 방어 로직을 반드시 적용해 주세요.- 토스앱 5.232.0 버전 이상에서만 지원해요. 이 버전 미만에서는
undefined가 반환되며, 미니앱 진입 시 업데이트 안내 화면이 표시돼요. - 실제 프로모션을 시작하기 전에, 테스트용 프로모션 코드로 최소 1회 이상 호출해야 합니다.
자세한 내용은 grantPromotionRewardForGame 문서를 참고해주세요.
비게임
비게임 미니앱에서 유저에게 토스 포인트를 지급하는 방법은 두 가지예요.
클라이언트에서 직접 프로모션을 실행하는 방식과, 서버를 통해 프로모션 포인트를 지급하는 방식(Server-to-Server)을 제공해요.
요청 위변조 방지 등 무결성이 중요한 경우에는 서버를 통한 지급 방식을 이용할 수 있어요.
주의하세요
- 서버 없이 지급 방식은
grantPromotionReward함수를 중복 호출하면 동일한 유저에게 리워드가 중복 지급될 수 있으니, 방어 로직을 반드시 적용해 주세요.
자세한 내용은 비게임 프로모션 가이드 문서를 참고해주세요.