Appearance
인앱결제 연동하기
앱인토스에서 인앱 결제를 연동하는 방법을 소개해요.
결제 항목에 따라 결제 방법을 선택해 주세요.
- 비실물 재화/서비스(게임 아이템, 구독 형태의 이용권 등)를 제공한다면 인앱결제를 연동하세요.
- 실물 재화/서비스를 제공한다면 간편결제(토스페이)를 연동해 주세요.
계약하기
인앱 결제 사용을 위해서는 계약이 필요해요.
계약은 콘솔에서 진행하며, 대표관리자만 진행합니다.
KYC 진행하기
인앱 결제 사용을 위해서는 본인 확인 절차(KYC)가 필요해요.
모든 설정을 완료하셨다면 검토를 요청하세요. 영업일 기준 5일 이내 승인해드려요. 
상품 등록하기
인앱 결제 상품을 등록합니다. +등록하기 버튼을 눌러주세요.
상품 정보를 등록해주세요.
- 상품 유형
- 소모품 : 사용하면 소진되며, 다시 사용하려면 재구매가 필요해요. (예시: 게임 아이템, 1회 이용권)
- 비소모품 : 한 번 구매하면 영구적으로 사용할 수 있어요. (예시: 광고 제거, 프리미엄 기능)
- 설명
- 해당 상품이 어떤 용도로 사용되는지 간단히 적어주세요. (예시: 캐릭터를 꾸미는 아이템, 광고 없이 콘텐츠 감상)
- 연속성 아이템일 경우, 꼭 기재해주셔야 원활한 검수가 이루어져요.
- 공급가
- 수수료가 제외된 공급 기준 금액이에요.
- 최소 400원 ~ 최대 1,400,000원까지 설정할 수 있어요.
- 판매가
- 사용자가 앱에서 실제로 결제하는 최종 금액이며, 공급가에 수수료가 더해진 가격이에요.
- 최소 지원 버전
- 이 상품을 사용할 수 있는 미니앱의 최소 버전을 선택해주세요. 구버전 사용자에게 노출되지 않도록 제한할 수 있어요.(출시된 미니앱이 없다면, 선택 가능한 최소 지원 버전도 보이지 않아요.)
- 노출 여부
- 심사 승인 후 바로 상품을 노출하려면 체크박스를 선택해주세요. 선택하지 않아도 나중에 직접 노출을 시작할 수 있어요.
위 내용을 입력 후 검토 요청하기 버튼을 눌러 검토를 요청하세요.
심사 완료까지는 영업일 기준 2일이 소요되요.
심사가 완료되면 등록한 인앱 결제 상품을 사용할 수 있어요.
참고하세요
등록한 인앱 결제 상품 기준으로 주문내역, 정산내역을 확인할 수 있어요.
인앱결제 상품 등록 가이드라인을 확인해 주세요.
개발하기
1. 상품 목록 가져오기
SDK를 통해 연동해 주세요.
콘솔에서 등록한 인앱 결제 상품 목록을 가져옵니다.
상품 목록을 화면에 표시할 때 사용해요.
IapProductListItem 페이지를 확인해주세요.
참고하세요
인앱결제를 샌드박스 앱에서 테스트할 때는 실제 등록/승인된 상품이 아니라,
테스트 상품 - 1, 테스트 상품 - 2 같은 mock 데이터가 노출돼요.
토스앱 내에서 동작할 때는 승인된 실제 상품 목록이 정상적으로 보여져요.
2. 인앱 결제 요청하기
SDK를 통해 연동해 주세요.
인앱 결제 결제창을 띄우고, 사용자가 결제를 진행해요.
결제 후 앱인토스 내부에서 실제 결제가 되었는지 검증을 진행합니다. 결제가 성공하면 결제 결과를 내려드려요.
만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
createOneTimePurchaseOrder 페이지를 확인해주세요.
주의하세요
현재 환불에 대한 최종 권한은 앱마켓에 있어요.
구글
결제 48시간 이내: 구글이 직접 환불 처리해요.
결제 48시간 이후: 개발사가 환불 요청은 할 수 있지만, 최종 판단과 승인은 여전히 구글이 해요.
개발자가 요청한 환불이 실패할 수도 있어요.
애플
- 모든 환불은 애플이 직접 판단하고 승인해요. 개발사는 환불 권한이 전혀 없어요.
⚠️ 구글의 경우, 48시간 이후에는 파트너사에서 직접 환불 요청할 수 있도록 환불 요청 API를 개발 중이에요.
하지만 아직은 API로 환불 요청이 불가해서 현재는 개발자분이 직접 구글 콘솔을 통해 환불 요청하셔야 해요.
⚠️ 애플은 환불 요청 자체가 불가능해서, 결제 상태만 조회할 수 있는 API만 제공돼요.
✅ 앱마켓을 통한 환불 요청 및 승인 여부를 확실히 알 수 없기 때문에, 소액으로만 테스트해 주세요.