Google Play 실시간 개발자 알림으로 판매 알림 받기

Google Play는 구매 상태가 바뀔 때마다 메시지를 보낼 수 있습니다. 새 구독, 갱신, 일회성 구매, 환불 같은 일입니다. 메시지는 내가 고른 Cloud Pub/Sub 주제(topic)로 갑니다. 전체 설정 과정, 메시지에 담긴 내용(가격은 없습니다), 그리고 이를 판매 알림으로 바꾸는 방법을 정리했습니다.

2026년 9월 26일 업데이트 · 8분 · 출처는 글 끝에

메뉴 이름은 영어 콘솔 기준입니다. 콘솔을 한국어로 쓰면 번역된 이름으로 보입니다.

RTDN의 동작 방식

실시간 개발자 알림(Real-time developer notifications, RTDN)은 Google Play의 서버 간 구매 이벤트입니다. Play가 이벤트를 Cloud Pub/Sub 주제에 게시하면, 내 코드는 Pub/Sub 구독(subscription)으로 받습니다. 메시지마다 base64로 인코딩된 data 필드가 하나 있고, 디코딩하면 DeveloperNotification이 나옵니다. packageName, eventTimeMillis, 그리고 subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification, pendingRefundReviewNotification(해결 방법을 제안할 수 있는 지불 거절 요청), testNotification 중 하나가 들어 있습니다.

Google 레퍼런스에서 기억할 문장:

“These notifications tell you only that the purchase state changed. They do not give you complete information about the purchase.”
(이 알림은 구매 상태가 바뀌었다는 사실만 알려 주며, 구매의 전체 정보를 담고 있지 않습니다.)
— Android Developers, Real-time developer notifications reference guide

받는 것은 purchaseToken(환불·무효화 알림에는 orderId도)입니다. 금액은 Google Play Developer API를 한 번 더 불러서 얻습니다(5단계).

판매에 중요한 알림 유형:

알림	유형	의미
`subscriptionNotification`	(4) `SUBSCRIPTION_PURCHASED`	새 구독 구매
	(2) `SUBSCRIPTION_RENEWED`	활성 구독 갱신
	(1) `SUBSCRIPTION_RECOVERED`	계정 보류에서 복구되었거나 일시중지에서 재개
	(3) `SUBSCRIPTION_CANCELED` · (13) `SUBSCRIPTION_EXPIRED` · (12) `SUBSCRIPTION_REVOKED`	취소, 만료, 만료 전 해지(revoke)
`oneTimeProductNotification`	(1) `ONE_TIME_PRODUCT_PURCHASED`	일회성 상품 구매
	(2) `ONE_TIME_PRODUCT_CANCELED`	대기 중인 일회성 구매를 사용자가 취소
`voidedPurchaseNotification`	`productType`, `refundType`	구매 무효화(환불·지불 거절). `orderId` 포함

유예 기간, 계정 보류, 일시중지, 가격 변경 등 전체 목록은 아래 레퍼런스에 있습니다.

1단계: Pub/Sub 주제 만들기

Google Cloud 콘솔에서 Pub/Sub을 열고, 내가 관리하는 아무 프로젝트에 주제를 만듭니다. 전체 이름을 적어 두세요. projects/your-project-id/topics/play-rtdn 같은 형태입니다.

2단계: Google Play에 게시 권한 주기

Cloud 콘솔에서 Pub/Sub을 열고 주제를 찾습니다.
주제의 권한(permissions) 화면을 엽니다.
서비스 계정 google-play-developer-notifications@system.gserviceaccount.com을 추가하고 Pub/Sub Publisher 역할을 줍니다.
Save를 누릅니다.

조직 정책으로 도메인 제한 공유(domain restricted sharing)를 쓰고 있다면, 이 Google Play 서비스 계정을 예외로 추가해야 권한을 줄 수 있다고 Google은 안내합니다.

3단계: Play Console에 주제 연결하기

Google Play Console을 열고 앱을 고릅니다.
Monetize › Monetization setup으로 갑니다.
페이지 맨 위의 Real-time developer notifications 섹션에서 Enable real-time notifications를 체크합니다.
Topic name에 전체 주제 이름을 넣습니다: projects/{project_id}/topics/{topic_name}
받을 내용을 고릅니다. “Get notifications for subscriptions and all voided purchases”는 일회성 상품 구매가 빠집니다. 일회성 상품의 판매 알림도 받으려면 “Get all notifications for subscriptions and one-time products”를 고르세요.
Save changes를 누른 뒤 Send test message를 누릅니다.

테스트 게시가 실패하면 주제 이름이 정확한지, 서비스 계정에 Pub/Sub Publisher 권한이 있는지 확인하라고 Google은 안내합니다. RTDN은 앱마다 설정하므로 앱마다 반복해야 하고, 모든 앱이 같은 주제를 가리켜도 됩니다.

4단계: 메시지 받기

주제에 구독을 붙입니다. Google Pub/Sub 문서의 설명대로 pull 구독은 “구독자 클라이언트가 Pub/Sub 서버에 메시지를 요청”하고, push 구독은 “Pub/Sub 서버가 구독자 애플리케이션에 요청을 보내 메시지를 전달”합니다. push는 내 엔드포인트가 성공 응답을 보내면 메시지가 확인(ack)되고, pull은 처리한 메시지를 직접 확인해야 다시 오지 않습니다.

Pub/Sub은 “최소 한 번 전달(at-least-once), 순서 보장 없음”이라 가끔 중복이 옵니다. Google의 RTDN 가이드도 messageId의 고유성을 확인해 중복 처리와 Developer API 할당량 낭비를 피하라고 권합니다.

// Push 엔드포인트: Pub/Sub이 {"message": {"data": "<base64>", "messageId": "…"}, "subscription": "…"}를 POST합니다
export async function onPush(request) {
  const { message } = await request.json();
  if (await alreadySeen(message.messageId)) return new Response(null, { status: 204 });
  const note = JSON.parse(atob(message.data)); // DeveloperNotification
  if (note.testNotification) return new Response(null, { status: 204 });
  await enqueueLookup(note.packageName, note.subscriptionNotification ?? note.oneTimeProductNotification ?? note.voidedPurchaseNotification);
  return new Response(null, { status: 204 }); // 2xx 응답이 메시지 확인(ack)
}

공개된 push 엔드포인트라면 push 구독 인증도 켜서 Pub/Sub이 보낸 요청이 아니면 거부하세요.

5단계: 구매 조회하기

앱에 접근할 수 있는 자격 증명(Play Console에 추가한 서비스 계정, 또는 androidpublisher 범위의 OAuth 토큰)으로 Google Play Developer API를 부릅니다.

구독: purchaseToken으로 purchases.subscriptionsv2.get을 부르면 구독 상태와 항목(line items)을 돌려주며, 항목마다 latestSuccessfulOrderId와 반복 결제 가격이 있습니다. 반복 결제 가격에는 할인과 세금이 빠져 있고, 실제 결제 금액은 아래의 주문에 있습니다.
일회성 상품: 상품 ID(sku)와 토큰으로 purchases.products.get을 부르면 orderId, 수량, 지역은 오지만 금액은 없습니다.
금액: orderId로 orders.get을 부르면 주문의 total, tax, developerRevenueInBuyerCurrency, listingPrice가 담긴 항목을 돌려줍니다.
환불: voidedPurchaseNotification에는 이미 orderId와 전체 환불인지 수량 기준 부분 환불인지가 들어 있습니다.

금액을 얻었으면 Slack, 푸시 알림, 메뉴바 앱 등 원하는 곳으로 알림을 보내면 됩니다.

Cloud 프로젝트를 운영하고 싶지 않다면

RevBell이 주제와 수신 서버를 대신 운영합니다. 주제를 직접 만드는 대신 Play Console에 RevBell 주제 projects/reviewbell-play-production/topics/reviewbell-rtdn을 붙여 넣으면 됩니다.

RevBell 서버는 알림마다 패키지 이름, 알림 유형, 구매 토큰, 상품 ID, (있으면) 주문 ID, 이벤트 시각만 최대 7일 동안 보관합니다. 구매자 식별자는 저장하지 않고, 소유가 확인되지 않은 앱의 알림은 도착하는 즉시 버립니다.
앱이 내 것임을 증명하려고 Mac 앱이 하루에 한 번쯤 수명이 짧은 Google 토큰을 보냅니다. 서버는 이 토큰으로 Google API를 두 번 부르고 저장하지 않습니다.
내 Mac이 내 앱의 알림을 가져와 내 Google 로그인으로 구매를 조회하므로 주문 금액은 RevBell 서버에 가지 않습니다. 판매는 보통 1–2분 안에 노치에 나타납니다. 판매 상세는 RevBell Pro 기능이고, 무료 플랜은 판매가 발생했다는 사실을 알려 줍니다.

자주 묻는 질문

알림에 가격이 들어 있나요?

아니요. 구매 토큰만 있고, 금액은 Developer API로 조회합니다(5단계).

여러 앱이 주제 하나를 같이 써도 되나요?

네. 알림마다 packageName이 있어서 주제 하나와 수신 서버 하나로 모든 앱을 처리할 수 있습니다.

일회성 상품 구매도 오나요?

3단계에서 “Get all notifications for subscriptions and one-time products”를 골랐을 때만 옵니다.

얼마나 빠른가요?

Google은 RTDN의 전달 시간을 공개하지 않습니다. RevBell 주제를 거쳐 Mac까지 오는 판매 알림은 보통 1–2분 안에 도착합니다.