인앱 결제

마치면 앱 안에서 디지털 상품을 팔 수 있어요. 스토어에 인앱 상품이 생기고, 구매·복원·환불이 앱과 내 서버에 바로 반영돼요. 상품 심사는 첫 앱 버전과 함께 받아요.

두 스토어의 영수증 확인·구독 갱신·환불을 직접 다루기 어려워서 구독 관리 도구(예: RevenueCat, Adapty, Qonversion)를 많이 써요. 아래 순서는 RevenueCat 기준이에요. 다른 도구나 직접 만든 서버도 순서(스토어 앱 연결 → 상품 → 서버 알림 → 앱 코드 → 테스트 구매)는 같아요.

#시작하기 전에

• 스토어에 앱 — App Store Connect·Play Console 에 앱이 있어야 해요(iOS 출시·Android 출시). Play 인앱 상품은 첫 AAB 를 올린 뒤에 만들 수 있어요.
• App Store 유료 앱 계약이 활성 — App Store 돈 받기.
• Google 15% 수수료 등록 — Google 돈 받기.

allob 이 지금 바로 연결하는 구독 관리 도구는 RevenueCat 이에요. 다른 도구나 직접 만든 서버는 웹훅을 받는 서버에서 allob 서버 SDK 로 결제 이벤트를 보내면 매출과 퍼널을 같이 봐요. 스토어 판매 보고서는 App Store Connect 연결로도 가져와요.

이 allob 사업 가이드를 읽고, 내 사업에 해당하는 할 일만 골라 진행해 줘: https://allob.app/docs/journey-iap.md
1. allob business view 와 allob path view --business 로 내 사업 모양(사업자 형태·돈 버는 방식·파는 나라)을 먼저 확인해.
2. 해당하지 않는 할 일은 왜 아닌지 한 줄로 알려 주고 allob step skip <id> --reason "…" 으로 넘겨.
3. 해당하는 할 일은 allob step view <id> 의 안내대로 하고, 끝나면 allob step done <id> --note "끝났다는 증거" 를 불러.
4. 본인 인증·서명·결제·약관 동의처럼 사람만 하는 곳에서는 멈추고 무엇을 누르면 되는지 알려 줘.
5. 되돌리기 어려운 답(과세 유형·계정 유형 등)은 내 폰으로 확인 요청이 와 — 명령이 보여 준 승인 링크를 알려 주고, 기다리는 동안 다른 할 일로 넘어가.

#RevenueCat 연결하기

RevenueCat 에 이 앱의 프로젝트를 만들고, 두 스토어 앱을 연결한 뒤 allob 에도 연결해요. 다른 도구를 쓰면 이 할 일은 건너뛰어요.

에이전트가 프로젝트를 만들고 두 스토어 앱(번들 id·패키지 이름)을 붙인 뒤, 꼭 필요한 권한만 가진 시크릿 키를 만들어 allob 에 연결해요. RevenueCat 은 앱마다 키가 달라서 제품마다 연결해요.

Play 앱 설정의 "credentials need attention" 경고는 첫 AAB 와 Play 인앱 상품이 생기면 사라져요. 그 전엔 그대로 둬도 돼요.

RevenueCat 로그인만 해 주세요. 결과는 allob 의 이 제품 연결 목록에서 볼 수 있어요.

#스토어 인앱 상품 만들기

App Store·Google Play 에 인앱 상품을 만들고, 구독 관리 도구의 상품·권한(RevenueCat 은 entitlement·offering)을 맞춰요.

• App Store 상품엔 심사용 스크린샷이 있어야 해요. 없으면 MISSING_METADATA 예요.
• Play 구독은 첫 AAB 뒤에 기본 요금제를 활성화할 수 있어요.
• 앱은 상품 id 가 아니라 구독 관리 도구의 권한이 켜져 있나로 판단해요.

첫 인앱 상품은 앱 버전과 같은 제출로 심사받아요(출시 단계).

에이전트가 끝까지 해요. App Store Connect·Play Console 로그인만 해 주세요. 만든 상품은 두 콘솔의 인앱 상품 목록에서 볼 수 있어요.

#스토어 서버 알림 연결하기

Apple·Google 서버 알림을 구독 관리 도구(또는 내 서버)에, 그 도구의 알림을 내 서버에 연결해요. 빠지면 환불·해지·갱신이 사용자가 앱을 다시 열 때까지 안 잡혀요.

• Apple — App Store 서버 알림(V2)을 운영·샌드박스 둘 다 받아요.
• Google — 실시간 알림은 Google Cloud 의 Pub/Sub 토픽을 거쳐 와요. 그래서 Google Cloud 프로젝트와 토픽이 먼저 있어야 해요(에이전트가 만들어요).
• 내 서버 웹훅 — 구독 관리 도구의 알림을 받아 확인하고, 운영 건만 기록해요. 이메일 같은 개인정보는 읽지 않아요. 여기서 allob 에 서버 결제 이벤트를 보내요.

환불 대응(Refund Control)을 켤지 골라요:

에이전트가 끝까지 해요. RevenueCat·App Store Connect·Play Console·Google Cloud 로그인만 해 주세요. 결과는 구독 관리 도구의 알림 기록에서 볼 수 있어요.

#앱에 결제 코드 넣기

앱에서 상품을 불러와 구매·복원하고, entitlement 로 권한을 주는 코드를 넣어요.

• 구매 직전에 이 기기의 allob 기기 ID 를 결제 정보로 넘겨요. 서버 결제 이벤트가 이 기기의 퍼널과 연결돼요.
• 복원은 비소모품·구독만이에요. 복원 때 코인 같은 보상을 다시 주지 않아요.
• 구독이면 결제 화면에 이용약관·처리방침 링크가 있어야 해요.

에이전트가 끝까지 해요. 고친 코드는 에이전트의 작업 내용에서 볼 수 있어요.

#테스트 구매로 확인하기

테스트 계정으로 한 번 사서, 스토어 → 구독 관리 도구 → 앱 → 내 서버까지 끝까지 도는지 확인해요.

• iOS 는 샌드박스 계정(TestFlight 빌드), Android 는 라이선스 테스트 계정(내부 테스트 빌드)으로 사요. 실제 돈은 나가지 않아요.
• 환불·해지 테스트까지 하면 알림 연결도 같이 확인돼요.

테스트 폰에서 샌드박스(또는 라이선스 테스트) 계정 로그인과 구매 확인만 해 주세요. 결제 창에 테스트 표시(예: [Sandbox])가 있는지 보고 눌러요.

#자주 걸리는 함정

한국에선 Google Play 대체 결제를 쓸 수 있어요(수수료 4%p 낮음). 대신 결제 흐름과 심사가 늘어요.

#출처

공식 안내와 마지막으로 맞춰 본 날: 2026-10-18

• RevenueCat 문서
• Apple 앱 내 구입
• Apple App Store 서버 알림
• Google Play 실시간 개발자 알림
• Google Play 서비스 수수료 — 한국 대체 결제
• Apple App Review 가이드라인 3.1.2(구독)
• 일본 금융청 前払式支払手段
• allob 문서 — 결제 기록하기

마크다운으로 보기 · llms.txt · 개인정보 처리방침 · 이용약관