사용 방법 질문
안녕하세요. 구독 결제 직후 토스 결제 화면에 ‘환불을 신청해주세요’라는 안내가 표시되고, 미니앱에서 이용권이 활성화되지 않아 문의드립니다. 토스 고객센터에서 개발 문의 채널로 안내받았습니다.
개발·테스트 환경
- 개발 환경: WebView
- SDK:
@apps-in-toss/web-framework3.9.0 - 기기: Android
- 토스 앱 버전: [확인 후 입력 / 확인하지 못했다면 ‘미확인’]
- 문제 발생 경로: [QR 테스트 / 실제 출시 환경 중 선택]
- appName:
follow-note
주문 정보
- 주문번호:
2a84a5bd-a569-45ab-8a5b-b21edf6dc6df - SKU:
sub.20jt.mvtiycdg.0d06391526 - 구독 콜백 URL:
https://flow-app-gdgz.onrender.com/api/subscriptions/webhook
발생 현상
- 구독 결제를 진행한 직후 토스 결제 화면에 **‘환불을 신청해주세요’**라는 안내가 표시됐습니다.
- 미니앱으로 돌아와도 구독 이용권이 활성화되지 않았으며, 구매 복구도 완료되지 않았습니다.
- 현재는 추가 피해를 막기 위해 미니앱의 신규 구매를 일시 중지한 상태입니다.
당시 확인한 결과
서버 mTLS 주문 상태 조회
status: PURCHASEDstatusDeterminedAt: 2026-11-03T13:01:13— 응답 원문
SDK getSubscriptionInfo 조회
status: ACTIVEisAccessible: trueexpiresAt: nullisAutoRenew: true- 조회 오류 없음
서버 웹훅 확인
- 당시 해당 주문과 연결된 인증된
subscription.status_changed이벤트가 저장된 것을 확인하지 못했습니다. - 2026년 11월 3일 13:01:14경 웹훅 요청이 HTTP 400으로 거절된 기록은 있습니다. 다만 본문 처리 전 거절되어 해당 주문의 이벤트인지는 확인하지 못했습니다.
- 현재 구현은 서버에서 주문을 검증하고 구독 권한 정보를 확인해야 이용권을 지급하도록 되어 있습니다. 이 대기 조건이 최초 지급을 막는지도 확인하고 싶습니다.
이후 자동 갱신 취소를 시도했고, Google Play에 환불도 신청했습니다. 위 상태는 당시 조회 결과이며 현재 상태는 재확인이 필요합니다. 자동 갱신 취소와 환불은 구분하고 있습니다.
확인 요청
-
해당 주문의 현재 결제·구독·환불 상태와 상품 지급 완료 처리 이력을 확인 부탁드립니다. SDK 지급 콜백 또는 완료 처리에서 실패한 원인도 확인 가능할까요?
-
최초 지급의 정확한 처리 순서를 안내 부탁드립니다.
processProductGrant호출, 서버 상품 지급,CREATED웹훅 발송, 지급 완료 처리의 선후관계가 궁금합니다. 구독 상태 웹훅을 받을 때까지 최초 지급을 보류하면 서로 기다리는 상황이 발생할 수 있나요? -
공식 문서의
CREATED예시에는 **`ACTIVE·accessGranted:true·expiresAt:null`**이 있습니다. 만료일이 없거나 웹훅이 아직 도착하지 않았을 때, 최초 이용권을 지급하는 공식 기준과 이용 기간 확인 방법을 안내 부탁드립니다. 임의로 만료일을 계산하지 않으려 합니다. -
등록한 콜백 URL의
callback.registration_verification처리 및 활성화 여부, 해당 주문의 웹훅 발송·실패·재시도 이력을 확인 부탁드립니다. 누락된 이벤트를 등록된 인증 방식으로 재전송할 수 있을까요? -
웹훅을 받지 못했을 때 파트너 서버가 현재 구독 권한을 확인할 수 있는 공식 조회 방법이 있나요? 주문 상태 조회 API에서는 현재 구독 이용 가능 여부와 만료일을 확인하지 못했습니다.
-
웹훅의
occurredAt,expiresAt처럼 시간대가 없는 시각은 한국시간으로 해석하면 되는지 확인 부탁드립니다.
참고로 아래 과거 사례와 화면 증상이 유사합니다. 당시 SDK 2.6.2에서 수정됐다는 답변을 확인했으나, 현재 저희 환경과 같은 원인이라고 단정하지는 않고 있습니다.
새 결제를 반복하지 않고 기존 주문을 확인하고자 합니다. 현재 환불 상태에 따라 복구 가능 여부도 함께 안내 부탁드리며, 추가로 필요한 로그나 진단 항목이 있으면 전달하겠습니다.
첨부 이미지는 문제 발생 당시 SDK 조회 결과입니다. 현재 상태를 촬영한 화면은 아닙니다.
appName (선택)
follow-note