개발하기

프로모션을 개발하기 전에 꼭 확인해 주세요.

• 사용자의 오인지를 방지하기 위해 토스에서 이미 사용 중인 명칭과 동일하게 사용하거나 다른 의미로 사용하는 것은 불가해요.

[예시]

• 포인트
  • 미니앱 내에서 통용되는 자체 리워드에는 ‘포인트’ 라는 명칭을 사용할 수 없어요.
    • ‘토스 포인트’가 지급된 것으로 오인할 수 있어요.
  • ‘토스 포인트’와 명확하게 구분할 수 있는 용어로 사용해 주세요.
• 출금, 인출 등
  • 현금화하는 것으로 오인할 수 있는 용어는 사용할 수 없어요.
  • 미니앱 내에서 가상 자산이 ‘토스 포인트’로 전환되는 경우라면 ‘토스 포인트 지급’ 으로 표기해 주세요.

게임

별도의 서버 연동 없이도 게임 미니앱 내에서 유저에게 토스 포인트를 지급하고, 혜택탭에 프로모션을 노출하여 트래픽을 키울 수 있어요.

주의하세요

• grantPromotionRewardForGame 함수를 중복 호출하면 동일한 유저에게 리워드가 중복 지급될 수 있으니, 방어 로직을 반드시 적용해 주세요.
• 토스앱 5.232.0 버전 이상에서만 지원해요. 이 버전 미만에서는 undefined가 반환되며, 미니앱 진입 시 업데이트 안내 화면이 표시돼요.
• 실제 프로모션을 시작하기 전에, 테스트용 프로모션 코드로 최소 1회 이상 호출해야 합니다.

자세한 내용은 grantPromotionRewardForGame 문서를 참고해주세요.

---

비게임

비게임 미니앱에서 유저에게 토스 포인트를 지급하는 방법은 두 가지예요.
클라이언트에서 직접 프로모션을 실행하는 방식과, 서버를 통해 프로모션 포인트를 지급하는 방식(Server-to-Server)을 제공해요.
요청 위변조 방지 등 무결성이 중요한 경우에는 서버를 통한 지급 방식을 이용할 수 있어요.

• 서버 없이 지급: SDK 함수 호출만으로 포인트를 지급해요.
• 서버를 통해 지급: 파트너사 서버에서 API를 직접 호출해 포인트를 지급해요.

주의하세요

• 서버 없이 지급 방식은 grantPromotionReward 함수를 중복 호출하면 동일한 유저에게 리워드가 중복 지급될 수 있으니, 방어 로직을 반드시 적용해 주세요.

자세한 내용은 비게임 프로모션 가이드 문서를 참고해주세요.