할인 코드
결제 과정에서 입력한 할인 코드로 주문 금액의 일정 비율을 할인하는 방법을 알아봅니다.
할인 코드는 카탈로그 상품의 결제 금액을 줄여 줍니다. 기프트 코드와 무료 아이템은 결제 없이 보상을 제공하는 반면, 할인 코드는 유료 상품의 일회성 구매에 적용됩니다. Tokenz는 각 상품의 단가에 할인율을 적용하고, 할인된 금액을 기준으로 세금을 계산한 뒤 최종 금액을 청구합니다.
Tokenz 대시보드에서 캠페인을 만든 뒤 구매자를 Tokenz Checkout으로 안내하세요. 구매자는 결제 전에 할인 코드를 적용하거나 해제할 수 있습니다.
개요
할인 코드 캠페인의 주요 구성과 제약은 다음과 같습니다.
- 할인율: 캠페인에 설정한 할인율이 주문 전체에 적용됩니다.
- 코드: 같은 할인율, 적용 기간 및 캠페인 한도를 공유하는 하나 이상의 코드입니다.
- 주문당 코드 하나: 다른 코드를 적용하려면 먼저 기존 코드를 해제해야 합니다.
- 일회성 구매: 구독 체크아웃과 결제 게이트웨이 주문에는 사용할 수 없습니다.
캠페인 설정 및 관리
할인 코드 캠페인은 Tokenz 대시보드에서 만들고 관리합니다. 대시보드에 할인 코드가 표시되지 않으면 Tokenz 지원팀에 문의해 계정에서 사용할 수 있는지 확인하세요.
Tokenz 대시보드에서는 다음 작업을 할 수 있습니다.
- 캠페인 이름과 설명 설정
- 1~99% 할인율 설정
- 같은 할인율을 공유하는 코드 추가
- 캠페인 전체 사용 한도, 수령인별 사용 한도 및 캠페인 예산 설정
- 캠페인 전체 한도 이하로 개별 코드의 사용 한도 설정
- 캠페인 게시, 일시 중지, 재개 및 종료
할인 코드 캠페인은 기프트 코드 캠페인과 같은 상태를 사용합니다.
draft: 작성 중입니다. 코드를 사용할 수 없으며 모든 필드를 수정할 수 있습니다.scheduled: 게시 후 시작 시각을 기다리는 상태입니다. 설정한 시작 시각부터 코드를 사용할 수 있습니다.active: 캠페인이 진행 중이며 코드를 사용할 수 있습니다.paused: 수동으로 일시 중지한 상태입니다. 코드를 사용할 수 없으며active상태로 재개할 수 있습니다.ended: 캠페인이 종료되어 코드를 사용할 수 없습니다. 이 상태는 되돌릴 수 없습니다.
개별 할인 코드의 상태는 active 또는 deactivated입니다. deactivated 상태의 코드는 캠페인이 active 상태여도 사용할 수 없습니다.
수령인 식별자
수령인별 사용 한도는 체크아웃의 수령인 식별자인 customerInfo.recipientId를 기준으로 적용됩니다. Tokenz는 이 값을 구매 항목을 받을 계정에 대해 판매자가 지정한 식별자로 취급하며, 게임에서 해당 계정을 직접 조회하지 않습니다.
판매자가 운영하는 상점에서는 체크아웃을 생성할 때 customerInfo.recipientId를 설정하세요. 기본값인 Merchant of Record 모델에서는 이 값 없이 생성한 체크아웃을 API가 거부합니다. Tokenz 웹 상점에서는 상점 세션의 수령인 식별자를 사용합니다.
수령인별 사용 한도 설정 여부와 관계없이, 전달한 모든 수령인 식별자에 다음 규칙이 적용됩니다.
- 앞뒤 공백을 제거합니다.
- 비어 있는 값은 사용할 수 없습니다.
- 최대 100자까지 입력할 수 있습니다.
- 대소문자를 구분하며 값이 정확히 일치해야 합니다.
수령인 식별자는 대소문자를 구분합니다. Player_123과 player_123은 서로 다른 수령인으로 취급되어 각각 별도의 한도가 적용됩니다. 같은 수령인의 모든 체크아웃에서 대소문자까지 동일한 식별자를 사용하세요. 플레이어가 다른 기기나 세션에서 체크아웃을 진행하더라도 식별자가 같으면 같은 수령인으로 취급됩니다.
체크아웃에 수령인 식별자가 있으면, 캠페인에 수령인별 사용 한도가 없더라도 해당 수령인의 캠페인 사용 내역이 기록됩니다.
체크아웃에 전달할 정보
구매할 유료 상품을 포함해 체크아웃을 생성하세요. customerInfo.recipientId에는 구매 항목을 받을 계정을 설정하세요. 코드 사용 내역은 해당 수령인에게 기록되며, 수령인별 사용 한도도 해당 수령인을 기준으로 계산됩니다.
상품 가격은 판매자가 설정한 판매 가격입니다. 할인 코드는 가격 플랜을 만들거나 변경하지 않습니다.
체크아웃에 포함된 쿠폰과 포인트를 먼저 차감한 뒤, 남은 금액에 할인 코드의 할인율을 적용합니다. 쿠폰·포인트와 할인 코드는 서로 대체하지 않고 함께 적용됩니다.
세금 별도 가격을 예로 들면, ¥1,000 상품에 ¥100 상당의 포인트를 사용하면 할인 코드 적용 전 금액은 ¥900입니다. 사용할 쿠폰이나 포인트가 없다면 해당 항목은 생략하세요.
체크아웃 진행 중
Tokenz Checkout에서는 할인 코드를 입력해 변경된 총액을 확인하거나, 코드를 해제하고 다른 코드로 바꿀 수 있습니다. 주문에는 한 번에 하나의 할인 코드만 적용됩니다. Tokenz는 코드 앞뒤의 공백을 제거한 뒤, 대소문자를 구분해 저장된 코드와 정확히 일치하는지 확인합니다.
코드를 적용하면 Tokenz는 유효성을 확인한 뒤 해당 주문이 사용할 횟수와 할인 금액을 캠페인 한도와 예산에서 예약합니다. 코드를 해제하면 예약도 해제되고 할인 전 가격으로 돌아갑니다. 결제가 완료되면 예약한 사용 횟수와 예산이 사용 처리됩니다. 주문이 실패·취소·차단되거나 결제 없이 만료되어도 예약이 해제됩니다. 자세한 내용은 예약 및 한도를 참고하세요.
위의 세금 별도 가격 예에서 20% 할인 코드를 적용하면 포인트 사용 후 남은 ¥900에서 ¥180이 할인됩니다. 세전 결제 금액은 ¥720이며, 이 금액을 기준으로 세금을 계산합니다. 포인트 ¥100은 그대로 적용되고, 할인 코드로 할인된 금액은 ¥180입니다.
가격 및 세금
할인율은 쿠폰과 포인트를 차감한 각 상품의 단가에 적용됩니다. 기존 세금 포함·별도 설정은 유지됩니다. 세금 포함 가격에서는 할인된 금액에 세금이 포함되며, 세금 별도 가격에서는 할인된 금액에 세금이 추가됩니다. 금액의 소수점 이하 자릿수 처리는 상품 한 개 단위로 이루어지므로, 주문 총액에 할인율을 한 번에 적용한 결과와 총 할인 금액이 조금 다를 수 있습니다.
예산
캠페인 예산은 캠페인에서 제공할 수 있는 총 할인 금액의 상한이며, 예산에 설정된 통화로 표시됩니다. 개별 주문이 아닌 캠페인 전체에 적용되는 한도입니다.
코드를 적용할 때 해당 주문의 전체 할인 금액을 예산 통화로 환산해 예약합니다. 남은 예산이 이 금액보다 적으면 코드를 사용할 수 없습니다. 남은 예산에 맞춰 할인율을 낮추지는 않습니다.
결제가 완료되면 해당 예산은 사용 처리된 상태로 유지됩니다. 코드를 해제하거나 주문이 실패·취소·차단·만료되면 예약한 예산이 해제됩니다. 환불해도 사용한 예산은 복구되지 않습니다.
지원 범위와 제한 사항
할인율은 1~99%로 설정할 수 있습니다. 할인 적용 후 결제 금액이 0이 되는 코드는 사용할 수 없습니다. 정액 할인, 특정 상품만 할인, 최소 주문 금액, 주문당 최대 할인 금액 및 여러 할인 코드의 동시 적용은 지원하지 않습니다.
예약 및 한도
체크아웃에서 코드를 적용하면 해당 주문에 대한 예약이 생성됩니다. 예약한 횟수와 금액은 결제 전에도 즉시 한도와 예산에 반영됩니다. 이를 통해 여러 구매자가 동시에 체크아웃을 진행할 때 한도를 초과하는 일을 방지합니다.
예약이 유지되는 동안 다음 항목이 반영됩니다.
- 캠페인 전체 사용 한도에 사용 횟수 1회
- 코드별 한도가 있는 경우 코드 사용 한도에 사용 횟수 1회
- 체크아웃에 수령인 식별자가 있고 캠페인에 수령인별 한도가 있는 경우 수령인별 사용 한도에 사용 횟수 1회
- 캠페인 예산에 할인 금액
결제 대기 중 최초 예약은 5분간 유지됩니다. 유효 기간이 남은 예약의 갱신이 성공하면 갱신 시점부터 5분으로 다시 설정됩니다. 갱신에는 30초의 대기 시간이 있으며, 이 시간 내 요청은 유효 기간을 연장하지 않습니다. 만료된 예약은 갱신으로 복구할 수 없습니다.
결제가 거절된 뒤를 포함해 주문이 다시 결제 대기 상태가 될 때마다 5분이 새로 주어집니다.
결제 처리 중에는 해당 시도가 성공·실패·만료될 때까지 예약이 유지됩니다. 결제가 진행 중이지 않은 상태에서 현재 예약 유효 기간이 지나면 예약이 해제되고 코드도 제거됩니다. 가격은 할인 코드 적용 전 금액으로 돌아갑니다.
예약에 반영되는 한도는 다음과 같습니다.
- 캠페인 전체 사용 한도: 모든 코드와 수령인의 사용 횟수를 합산합니다. 한도에 도달하면 코드를 더 이상 적용할 수 없습니다.
- 코드 사용 한도: 개별 코드에 한도가 설정된 경우 해당 코드의 사용 횟수를 계산합니다. 예약이 유지되는 동안 코드별 한도와 캠페인 전체 한도에 모두 반영됩니다. 결제가 완료되면 사용 처리되며, 코드를 해제하거나 예약이 해제되면 예약한 사용 가능 횟수가 복구됩니다. 코드별 한도는 캠페인 전체 한도를 초과할 수 없습니다.
- 수령인별 사용 한도: 한 수령인의 사용 횟수를 계산합니다. 한도에 도달한 수령인은 코드를 더 이상 사용할 수 없지만, 다른 수령인에게는 영향을 주지 않습니다. 이 한도가 설정된 캠페인은 체크아웃에 수령인 식별자가 없으면 적용할 수 없습니다.
유효성 검사를 통과하지 못한 코드는 예약을 생성하지 않습니다.
주문 및 환불
주문이 완료되면 캠페인, 코드, 할인율 및 할인 금액이 주문에 기록됩니다. 유료 상품은 기존의 주문 완료 처리 방식에 따라 지급하세요. 할인 코드 사용에 대한 별도 알림이나 추가로 지급할 보상은 없습니다.
환불은 실제 결제 금액을 기준으로 처리하세요. 부분 환불 시에는 할인 적용 후 단가를 기준으로 계산합니다. 주문을 환불해도 캠페인 전체·코드별·수령인별로 차감된 사용 가능 횟수나 예산은 복구되지 않습니다.
코드를 사용할 수 없는 경우
다음과 같은 경우 코드를 사용할 수 없습니다. 체크아웃에 오류가 표시되며 가격은 변경되지 않습니다.
- 주문에 이미 할인 코드가 적용되어 있습니다. 다른 코드를 입력하려면 먼저 기존 코드를 해제해야 합니다.
- 구독용 체크아웃입니다.
- 결제 게이트웨이 주문입니다. 할인 코드는 Merchant of Record(MoR) 모델 주문에만 적용됩니다.
- 할인 적용 후 결제 금액이 0이 됩니다.
- 수령인별 사용 한도가 있지만 체크아웃에 수령인 식별자가 없거나, 전달한 식별자가 유효하지 않습니다. 식별자의 유효성은 수령인별 한도가 없어도 검사합니다.
- 체크아웃에 지역 정보가 없어 세금을 다시 계산할 수 없습니다.
- 계정에 자동 세금 계산이 설정되어 있지 않습니다.
- 주문이 더 이상 결제 대기 상태가 아닙니다.
- 해당 계정에서 코드를 찾을 수 없거나 코드의 모드(테스트 또는 라이브)가 체크아웃과 다릅니다.
- 코드가 활성 상태가 아닙니다.
- 코드별 사용 한도에 도달했습니다.
- 캠페인을 사용할 수 없는 상태입니다. 작성 중, 일시 중지, 종료 상태이거나 예약된 시작 시각이 되지 않은 경우가 해당합니다.
- 캠페인 종료 시각이 되었거나 지났습니다.
- 할인 코드 캠페인에 속한 코드가 아닙니다.
- 캠페인 전체 사용 한도에 도달했습니다.
- 해당 수령인의 수령인별 사용 한도에 도달했습니다.
- 남은 캠페인 예산으로 해당 주문의 전체 할인 금액을 충당할 수 없습니다.
테스트
캠페인을 시험할 때는 테스트 모드를 사용하세요.
- Tokenz 대시보드의 테스트 모드에서 캠페인과 코드를 만드세요.
- 테스트 캠페인과 코드는 라이브 데이터와 분리됩니다. 테스트 체크아웃에서는 테스트 코드만, 라이브 체크아웃에서는 라이브 코드만 사용할 수 있습니다.
- Tokenz Checkout에서 코드를 적용하고 해제해 본 뒤 테스트 결제를 완료하세요. 코드를 적용하면 할인된 총액이 표시되고, 해제하면 할인 전 금액으로 돌아가야 합니다. 결제가 완료된 테스트 주문에는 할인 내역이 남아 있어야 합니다.