일회성 결제 레퍼런스 >
상품 목록 조회, 결제 요청, 주문 복원, 주문 상태 조회 API를 확인할 수 있어요.
인앱 결제
앱인토스의 인앱 결제를 연동해 디지털 상품과 권한, 콘텐츠를 손쉽게 판매해 보세요.
구매 흐름을 짧게 만들면 사용자는 더 쉽게 결제하고, 매출은 빠르게 늘릴 수 있어요.
인앱 결제란 무엇인가요
인앱 결제는 앱 안에서 유료 상품을 바로 구매할 수 있는 결제 방식이에요.
사용자는 앱을 떠나지 않고도 필요한 기능이나 아이템, 콘텐츠를 결제할 수 있어요.
인앱 결제 상품은 소모성 아이템과 비소모성 아이템으로 나뉘어요.
- 소모성 아이템: 사용하면 사라지는 상품이에요. 다시 사용하려면 다시 구매해야 해요.
- 예: 게임 아이템, 코인, 힌트 이용권
- 비소모성 아이템: 한 번 구매하면 계속 사용할 수 있는 상품이에요.
- 예: 프리미엄 기능 해제, 광고 제거, 특정 콘텐츠 이용 권한
인앱 결제를 사용하면 어떤 점이 좋나요
- 사용자가 앱을 벗어나지 않고 바로 결제할 수 있어, 결제 중 이탈을 줄일 수 있어요.
- 앱 출시 초기부터 유료 아이템이나 구독 상품을 판매해 바로 수익을 만들 수 있어요.
- 소모성 아이템과 비소모성 아이템을 함께 구성해 다양한 결제 모델을 만들 수 있어요.
- 사용 목적에 맞는 상품을 제공해 매출을 더 크게 키울 수 있어요.
참고해 주세요
- 인앱 결제 환불은 Apple과 Google의 정책을 따르고 있어요.
- 판매가는 공급가에 부가가치세(VAT)가 더해진 금액이에요.
- 결제가 진행되는 동안 앱 안의 기능, 예를 들면 음악이나 영상 재생은 잠시 멈추고 결제가 끝나면 자동으로 다시 이어지도록 처리해 주세요.
콘솔에서 설정하기
1. 사업자 정보 등록하기
인앱 결제를 연동하려면 먼저 사업자 정보를 등록해야 해요.
사업자 정보가 등록되어 있어야 이후 단계인 약관 동의와 정산 정보 입력을 진행할 수 있어요.
사업자 정보 등록 방법은 다음 가이드를 참고해 주세요.
2. 정산 정보 입력하기
인앱 결제 수익을 정산받으려면 정산 정보를 등록해야 해요.
워크스페이스의 '정보' 탭에서 정산 정보를 입력한 뒤 검토 요청을 해 주세요.
검토에는 영업일 기준 평균 2~3일이 걸려요.
꼭 확인해 주세요
예금주명은 통장 사본에 적힌 이름과 한 글자도 다르지 않게 입력해 주세요.
다르게 입력하면 정산이 지연될 수 있어요.
3. 인앱 상품 등록하기
상품 정보를 정확하게 입력하면 사용자가 구매 내용을 명확히 이해할 수 있고,
운영 중 분쟁이나 환불 이슈를 줄일 수 있어요.
참고하세요
등록할 수 있는 상품 수에 제한이 있어요.
- 게임 미니앱: 최대 80개
- 비게임 미니앱: 최대 30개
상품 유형
상품의 사용 방식에 맞게 유형을 선택해 주세요.
현금성, 환가성 상품이나 토스 포인트와 결합해 제공하는 상품은 판매할 수 없어요.
- 소모품
사용하면 소진되는 상품이에요. 다시 사용하려면 재구매해야 해요.
예를 들어 게임 아이템, 내부 재화 충전, 1회 이용권이 있어요. - 비소모품
한 번 구매하면 계속 사용할 수 있는 상품이에요.
예를 들어 광고 제거, 소장형 콘텐츠가 있어요. - 자동 갱신 구독
정해진 주기마다 자동으로 결제되며, 취소 전까지 계속 이용할 수 있어요.
예를 들어 월간 멤버십, 정기 콘텐츠 구독이 있어요.
상품명
상품명은 사용자가 받는 기능과 조건을 그대로 드러내야 해요.
- 실제 제공 내용과 일치하게 작성해 주세요.
- 과장하거나 오해를 부르는 표현은 사용할 수 없어요.
예를 들어 이용 기간이 정해져 있는데도 "무제한"이라고 쓰면 안 돼요.
상품 이미지
상품 이미지는 사용자가 상품을 직관적으로 이해할 수 있도록 구성해 주세요.
- "30일 이용권", "100코인"처럼 식별에 필요한 텍스트를 넣을 수 있어요.
- 이벤트성 문구를 넣는 경우, 반드시 이벤트 기간을 함께 표시해 주세요.
- 해상도는 1024 × 1024px로 등록해야 해요.
- 저작권 문제가 없는 이미지만 사용해야 해요. 이미지는 파트너사가 직접 확보해야 해요.
- 선정적이거나 폭력적이거나 불쾌감을 줄 수 있는 이미지는 사용할 수 없어요.
공급가
공급가는 부가가치세(VAT)가 제외된 금액이에요.
- 최소 400원부터 최대 1,400,000원까지 설정할 수 있어요.
- 10원 단위로만 입력할 수 있어요.
- 공급가를 입력하면 판매가는 자동으로 계산돼요.
- 판매가를 먼저 입력해 공급가를 자동 계산하는 기능은 현재 지원하지 않아요.
판매가
판매가는 사용자가 실제로 결제하는 최종 금액이에요.
공급가에 부가가치세가 더해진 금액으로 자동 설정돼요.
자동 갱신 구독 전용 설정
자동 갱신 구독 유형을 선택하면 아래 항목을 추가로 설정할 수 있어요.
자동 갱신 주기
결제가 반복되는 간격을 선택해 주세요.
- 매주: 7일마다 자동으로 결제돼요.
- 매월: 30일마다 자동으로 결제돼요.
- 매년: 365일마다 자동으로 결제돼요.
할인
구독 진입을 유도하기 위한 할인 혜택을 선택적으로 설정할 수 있어요.
무료 체험
일정 기간 동안 결제 없이 정기 결제 혜택을 이용할 수 있어요.
무료 체험이 끝나면 자동으로 유료 결제가 진행돼요.
- 기간: 3일 / 1주 / 2주 / 1개월 중 선택
신규 구독 할인
처음 정기 결제를 시작하는 사용자에게 일정 기간 할인된 가격으로 제공하는 혜택이에요.
- 할인 기간과 할인 공급가를 입력하면 할인 판매가가 자동으로 계산돼요.
재구독 할인
이전에 구독을 해지한 사용자에게 재구독 시 할인된 가격으로 제공하는 혜택이에요.
- 할인 기간과 할인 공급가를 입력하면 할인 판매가가 자동으로 계산돼요.
상품 등록을 완료하면 상품 목록 화면에서 등록된 상품을 확인할 수 있어요.
4. 결제 알림 URL 등록하기
구독 갱신, 해지 등 결제 상태가 변경될 때 알림을 받을 URL을 등록할 수 있어요.
URL을 등록하면 상태 변경 시 해당 URL로 HTTP 요청이 전달돼요.
결제 알림 URL
결제 상태 변경 알림을 수신할 서버 URL을 입력해 주세요.
Basic Auth 헤더
선택적으로 Basic Auth 헤더 값을 입력할 수 있어요.
입력하면 알림 요청의 HTTP 헤더에 아래와 같이 포함돼요.
Authorization: Basic {Basic Auth 헤더 값}5. 결제, 환불 내역 확인하기
결제 내역
사용자가 미니앱에서 결제한 상품 내역이에요.
- 지급완료는 사용자에게 구매 상품까지 모두 제공됐다는 뜻이에요.
- 결제 완료는 결제는 됐지만 구매 상품이 아직 지급되지 않은 상태를 뜻해요.
마켓별 환불 정책
인앱 결제 환불은 사용자의 운영체제(OS)와 마켓 정책에 따라 처리 방식이 달라요.
아래 내용을 참고해 주세요.
Android
안드로이드 사용자가 앱에서 환불을 요청하면, 앱인토스 콘솔에서 요청 내역을 확인할 수 있어요.
- 사용자는 토스 앱에서 직접 환불을 요청해요.
- 파트너사는 앱인토스 콘솔의 '환불 내역' 메뉴에서 요청 건을 확인하고 승인 또는 반려를 처리할 수 있어요.
- 단, 최종 승인과 거절 여부는 Google Play가 결정해요.
환불 처리 결과는 다음과 같이 안내돼요.
- 사용자에게 푸시 알림으로 발송돼요.
- 사용자는 주문 상세 화면에서도 처리 결과를 확인할 수 있어요.
- 파트너사 또는 Google Play가 환불을 거절한 경우에도 동일하게 알림이 발송돼요.
파트너사는 내부 정책과 Google Play 정책을 함께 검토한 뒤 환불 요청을 처리해 주세요.
iOS
iOS 사용자의 환불은 Apple이 전적으로 관리해요.
- 모든 환불은 Apple이 직접 판단하고 승인해요.
- 파트너사는 환불을 승인하거나 거절할 수 없어요.
- Apple은 환불 요청 기능을 외부에 제공하지 않아요.
- 파트너사는 결제 상태 조회 API로 상태만 확인할 수 있어요.
따라서 iOS 결제 건은 환불 처리 권한이 없으며, 결제 상태 조회만 가능해요.
환불 내역
사용자가 환불을 요청한 내역이에요. 환불 요청 사유를 확인하고 요청 반려 및 요청 승인을 할 수 있어요.
인앱 결제로 결제한 사용자는 토스 앱에서 '환불받기' 버튼을 눌러 환불을 요청할 수 있어요.
Android 환불 방법
iOS 환불 방법
환불 요청 승인
파트너사가 환불 요청을 승인한 내역이에요. 요청을 승인하면, 앱마켓에 심사가 요청돼요.
환불 요청 반려
파트너사가 환불 요청을 반려하거나, 앱마켓에서 환불을 반려한 내역이에요.
환불 완료
앱마켓에서 환불이 완료된 내역이에요.
6. 성과 대시보드
개발과 연동을 완료한 인앱 결제의 성과 지표를 한 화면에서 확인할 수 있어요.
매출 흐름과 사용자의 결제 행동을 함께 분석해 상품 구성과 운영 전략을 개선해 보세요.
데이터는 D+1 오전 8시 이후부터 순차적으로 업데이트돼요.
- 매출 지표
- 총 결제 금액, 총 매출, 결제자당 평균 매출, 결제 사용자당 매출
- 사용자 지표
- 활성 사용자 수, 결제 사용자 수, 신규 결제 사용자 수, 재결제 사용자 수, 결제율, 최종 전환율
개발 연동하기
구독결제 레퍼런스 >
구독 상품 조회, 구독 결제 요청, 구독 상태 조회 API를 확인할 수 있어요.
자주 묻는 질문
인앱 결제 수수료는 앱마켓 수수료 15% (향후 매출에 따라 변동 가능) + 토스 수수료 5%가 적용돼요.
자세한 내용은 정산 이해하기 > 인앱 결제 항목을 확인해 주세요.
인앱 결제는 샌드박스에서 테스트할 수 있어요. 가이드를 확인해 주세요.
iOS 사용자의 경우 애플 고객센터로 안내해 주세요. (애플에 모든 권한이 있어요.)
안드로이드 사용자의 경우 가이드처럼 토스 앱 내에서 환불 신청을 할 수 있게 안내해 주세요.