Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about Play Billing Library version deprecation.
Google Play 결제 시스템은 Android 앱에서 디지털 제품 및 콘텐츠를 판매할 수 있게 해주는 서비스입니다. 개발자가 일회성 구매를 통해 수익을 창출하거나 서비스 정기 결제를 제공할 수 있습니다. Google Play는 Android 앱 및 서버 백엔드와 통합할 수 있는 완전한 API를 제공하여 사용자가 익숙하고 안전한 Google Play 구매를 이용할 수 있도록 지원합니다.
통합 아키텍처
이 섹션에서는 개발자가 빌드할 수 있는 다양한 기능 모듈과 이 프로세스를 간소화하는 데 사용할 수 있는 API 및 라이브러리를 소개합니다.
그림 1. 일반적인 Google Play 결제 통합 다이어그램
Play 결제 라이브러리를 사용하여 Google Play 결제 시스템을 Android 앱과 통합할 수 있습니다. 이 라이브러리를 사용하면 앱의 각 사용자가 사용할 수 있는 현지화된 제품 및 기타 필수 사용자 작업(예: 구매 흐름 시작, 구매 흐름의 결과 처리 등)을 제공하는 Google Play 서비스 레이어와 통신할 수 있습니다.
필요한 개발자 흐름을 만들 수 있도록 Google Play 결제 시스템을 서버 백엔드와도 통합해야 합니다. 이는 효율적이고 안전한 구매 관리 및 크로스 플랫폼 사용 권한을 위해 필수적입니다.
이 통합은 Google Play Developer API에서 제공하는 Subscriptions and in-purchase purchases API를 사용하여 만들 수 있습니다. 백엔드 통합은 일부 Google Cloud Platform 도구도 사용합니다.
그림 2. Google Play Developer API에서 제공하는 API 및 서비스
용어
이 섹션에서는 Google Play 결제 솔루션을 구현할 때 접할 수 있는 대략적인 기술 및 개념을 나열하고 설명합니다. 통합 가이드를 따라 진행할 때 이 목록을 참고하세요.
기술
Google Play. 사용자가 앱 및 기타 디지털 제품을 다운로드할 수 있는 온라인 상점입니다.
Google Play Console. Google Play에 앱을 게시할 수 있는 인터페이스를 제공하는 플랫폼입니다. Google Play Console에서는 Google Play를 통해 판매하는 제품이나 콘텐츠를 비롯하여 앱에 관한 세부정보도 표시합니다.
Cloud Pub/Sub. 독립적인 애플리케이션 간에 메시지를 주고받는 데 사용할 수 있는 완전 관리형 실시간 메시지 서비스입니다. Google Play에서는 Cloud Pub/Sub를 사용하여 실시간 개발자 알림을 전달합니다. Cloud Pub/Sub를 사용하려면 Cloud Pub/Sub API가 사용 설정된 GCP(Google Cloud Platform)에 프로젝트가 있어야 합니다. GCP와 Cloud Pub/Sub를 잘 알지 못한다면 빠른 시작 가이드를 참고하세요.
보안 백엔드 서버. Google Play 결제 시스템을 앱에 통합하는 일환으로 보안 백엔드 서버를 사용하여 구매 확인, 정기 결제 관련 기능, 실시간 개발자 알림 처리와 같은 결제 관련 작업을 구현하는 것이 좋습니다.
Google Play 스토어 앱. Google Play와 관련된 모든 작업을 관리하는 앱입니다. 앱의 모든 요청은 Google Play 스토어 앱에 의해 처리됩니다.
개념
흐름. 흐름은 결제 관련 작업과 연관된 일반적인 단계를 보여줍니다. 예를 들어 구매 흐름에는 사용자가 제품을 구매할 때 연관된 단계가 요약되어 있습니다. 정기 결제 흐름은 정기 결제가 상태 간에 전환되는 방식을 보여줄 수 있습니다.
사용 권한. 사용자가 인앱 상품을 구매하면 앱 내에서 그 제품을 사용할 사용 권한이 부여됩니다. 일회성 제품의 경우 사용자가 제품에 영구적으로 액세스할 수 있습니다.
정기 결제의 경우 사용자는 정기 결제가 활성 상태인 동안 액세스할 수 있습니다.
제품 ID. 특정 제품 유형의 ID입니다.
구매 토큰. Google Play에서 제품에 대한 구매자의 사용 권한을 나타내는 문자열입니다. Google 사용자가 특정 제품의 비용을 지불했음을 나타냅니다.
주문 ID. Google Play에서 금융 거래를 나타내는 문자열입니다.
주문 ID는 금융 거래가 발생할 때마다 생성됩니다. 이 문자열은 구매자에게 이메일로 전송되는 영수증에 포함됩니다. Google Play Console의 주문 관리 섹션에서 주문 ID를 사용하여 환불을 관리할 수 있습니다. 주문 ID는 판매 및 판매 대금 보고서에서도 사용됩니다.
다음 단계
Google Play 결제 시스템을 앱 및 서버 백엔드와 통합하려면 설정 가이드를 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Google Play's billing system is a service that enables you to sell digital products\nand content in your Android app, whether you want to monetize through one-time\npurchases or offer subscriptions to your services. Google Play offers a full set\nof APIs for integration with both your Android app and your server backend that\nunlock the familiarity and safety of Google Play purchases for your users.\n| **Note:** Google Play's billing system is only for digital items. For physical goods and services, or other non-digital content, see the [Google Pay SDK](https://developers.google.com/pay/api/android/overview).\n\nIntegration architecture\n------------------------\n\nThis section introduces the different functional modules that you can build and\nthe APIs and libraries available to simplify the process.\n**Figure 1.** Diagram of a typical Google Play billing integration.\n\nYou can integrate Google Play's billing system with your Android app using the [Play\nBilling Library](/reference/com/android/billingclient/classes). This library\nenables communication with the Google Play Services layer that provides the\nlocalized product offering available to each user in your app, as well as\nmethods to handle other necessary user operations, like launching the purchase\nflow and handling its outcome.\n\nYou should also integrate Google Play's billing system with your server backend to\ncreate the necessary developer flows. This is essential to guarantee that your\npurchase management and cross-platform entitlements are efficient and secure.\nYou can create this integration with the [Subscriptions and in-app purchases\nAPI](https://developers.google.com/android-publisher#subscriptions) provided by\nthe Google Play Developer API. The backend integration also leverages some\nGoogle Cloud platform tools.\n**Figure 2.** APIs and services provided by the Google Play Developer API.\n\nTerminology\n-----------\n\nThis section lists and describes the high-level technologies and concepts that\nyou might encounter when integrating Google Play's billing system into your app.\nReference this list as you proceed through the integration guidance.\n\n### Technologies\n\n- [**Google Play**](https://play.google.com). An online store where users can download apps and other digital products.\n- [**Google Play Console**](https://play.google.com/console). A platform that provides an interface where you can publish your app to Google Play. The Google Play Console also shows details about your app, including any products or content that you sell with Google Play.\n- [**Google Cloud Console**](https://console.developers.google.com/). A platform that manages backend APIs, such as the Google Play Developer API.\n- [**Google Play Billing Library**](/google/play/billing/integrate). An API that you can use to integrate Google Play's billing system into your app.\n- [**Google Play Developer API**](https://developers.google.com/android-publisher/). A REST API that you can use to programmatically handle publishing and app management tasks.\n- [**Cloud Pub/Sub**](https://cloud.google.com/pubsub/). A fully managed real-time messaging service that enables you to send and receive messages between independent applications. Google Play uses Cloud Pub/Sub to deliver Real-time developer notifications. To use [Cloud\n Pub/Sub](https://cloud.google.com/pubsub/), you must have a project on the [Google Cloud Platform (GCP)](https://cloud.google.com/) with the Cloud Pub/Sub API enabled. If you aren't familiar with GCP and Cloud Pub/Sub, see the [Quickstart guide](https://cloud.google.com/pubsub/docs/quickstart-console).\n- [**Real-time developer notifications**](/google/play/billing/getting-ready#configure-rtdn). A mechanism that lets you monitor state changes for Google Play-managed subscriptions in real time by leveraging [Cloud\n Pub/Sub](https://cloud.google.com/pubsub).\n- **Secure backend server**. As part of integrating Google Play's billing system into your app, we strongly recommend that you use a secure backend server to implement billing-related tasks such as purchase verification, subscription-specific features, and handling Real-time developer notifications.\n- **Google Play Store app**. An app that manages all operations related to Google Play. All requests made by your app are handled by the Google Play Store app.\n\n### Concepts\n\n- **Flow** . A flow shows the typical steps involved in a billing-related task. For example, a *purchase flow* outlines the steps involved when a user purchases your product. A *subscription flow* might show how a subscription transitions between states.\n- **Entitlement** . When a user purchases an in-app product, they are then *entitled* to that product within your app. For one-time products, this means that the user should now have permanent access to the product. For subscriptions, this means that the user should have access while the subscription is active.\n- **Product ID**. The ID of a specific product type.\n- **Purchase token**. A string that represents a buyer's entitlement to a product on Google Play. It indicates that a Google user has paid for a specific product.\n- **Order ID** . A string that represents a financial transaction on Google Play. An order ID is created every time a financial transaction occurs. This string is included in a receipt that is emailed to the buyer. You can use the order ID to manage refunds in the **Order Management** section of the Google Play Console. Order IDs are also used in sales and payout reports.\n\nNext steps\n----------\n\nTo begin integrating Google Play's billing system with your app and server backend,\nsee the [setup guide](/google/play/billing/getting-ready)."]]
