개발자 제공 결제 API

자격을 갖춘 개발자는 특정 국가의 사용자에게 앱에서 개발자 제공 결제 시스템을 제공하고 그 결과 발생하는 거래를 Google에 보고할 수 있습니다. 앱을 배포하는 위치와 자격 요건에 따라 앱에서 빌드할 수 있는 개발자 제공 결제의 두 가지 버전이 있습니다.

이 가이드에서는 두 서비스 모두에 사용해야 하는 API를 다룹니다. 이러한 API를 사용하기 전에 프로그램 페이지를 검토하고 관련 프로그램에 등록해야 합니다.

용어집

이 가이드에서는 다음과 같은 용어가 사용됩니다.

  • 개발자 제공 결제 API: 관련 화면을 사용자에게 표시하고 개발자가 개발자의 개발자 제공 결제 시스템에서 완료된 거래를 보고할 수 있도록 하는 데 사용되는 API입니다.
  • 개발자 제공 결제 시스템: 개발자의 개발자 제공 결제 시스템으로, Google Play의 결제 시스템과 함께 제공되거나 그 자체로 제공될 수 있습니다(자격 요건에 따라 다름).
  • 외부 거래: Google Play의 결제 시스템 외부에서 발생하는 거래입니다.
  • 외부 거래 토큰: 사용자가 개발자 제공 결제 시스템을 완료할 때 개발자가 사용할 수 있도록 Play 결제 라이브러리를 통해 개발자에게 제공되는 토큰입니다. 이 토큰은 Google Play에 구매 성공을 알리는 데 사용됩니다.
  • 외부 거래 ID: 개발자가 거래를 식별하기 위해 생성하는 고유 식별자입니다.

사용자가 선택할 수 있는 개발자 제공 결제 제공

이 섹션에서는 Google Play의 결제 시스템 사용을 선택할 수 있는 개발자 제공 결제를 사용자에게 제공하는 방법을 설명합니다. API를 사용하기 전에 먼저 다음 사항을 확인하세요.

Google Play 결제 통합 권장 모듈의 나머지는 개발자가 기존 통합을 진행할 때 이미 적용한 것과 동일합니다.

또한 Google Play Developer API 통합 설정을 준비하시기 바랍니다. 이 설정은 백엔드 통합에서 사용됩니다.

Play Console에서 구성

해당 사용자 선택 프로그램이 포함된 개발자 제공 결제 등록을 완료하고 개발자 제공 결제 API와 통합된 개발자는 Play Console을 통해 개발자 제공 결제 설정을 관리할 수 있습니다.

  • 요건을 충족하는 각 앱에 개발자 제공 결제 시스템을 제공할지 여부를 선택할 수 있습니다.
  • 가이드라인에 따라 결제 수단 로고를 업로드하여 모든 형식 사양에 따릅니다. 이 가이드라인을 준수하지 않는 이미지는 사용자 선택 화면의 개발자 제공 결제 시스템에 표시되지 않습니다. 참고: 결제 수단 로고를 포함하는 것은 선택사항이지만 포함하는 것이 좋습니다.
  • 정기 결제를 판매하는 경우 필수 정기 결제 관리 링크를 제공합니다.
설명용 UI로, 변경될 수 있습니다.

사용자 환경

클라이언트 측 API를 사용하면 다음 기능을 설정할 수 있습니다.

  • Google Play가 관련 정보 및 사용자 선택 화면을 렌더링하고 관리합니다.
  • 사용자가 Google Play 결제 시스템을 사용하기로 선택하면 결제 흐름에서는 Google Play의 결제 표준 인터페이스가 계속 사용됩니다.

개발자 앱

결제 서비스 선택 화면

이 예시는 설명을 위한 것입니다.

사용자 선택 화면

사용자 선택 화면에는 개발자의 개발자 제공 결제 시스템과 Google Play 결제 시스템 중 하나를 선택할 수 있는 옵션이 표시됩니다.

개발자 제공 결제 옵션의 구성

사용자 선택 화면에 표시되는 개발자 제공 결제 옵션은 다음과 같은 UI 요소로 구성됩니다.

  1. 앱 아이콘
  2. 앱 이름
  3. 개발자가 제공하는 결제 수단이 포함된 이미지 애셋
  4. 그 밖의 표시기(and more UI 요소는 이미지 애셋의 일부가 아님)

결제 수단용 이미지 애셋

단일 이미지 애셋은 여러 개의 결제 수단 카드로 구성되며 이 가이드라인에 정의된 사양을 준수해야 합니다.

크기

192dp X 20dp

카드 간격

8dp

파일 형식

PNG, 투명한 배경

여러 결제 수단

개발자는 이미지 애셋에 포함할 결제 수단 아이콘의 수를 최대 5개까지 선택할 수 있습니다.

그 밖에 다른 이미지 또는 텍스트는 이미지에 포함해서는 안 됩니다.

카드 사양

이미지 애셋에 포함된 결제 수단 카드는 크기, 간격, 스타일에 관한 다음 가이드라인을 따라야 합니다.

카드 크기 32dp X 20dp
안쪽 패딩 3dp
윤곽선 1dp(크기에 내부 획 포함), 반경 2dp, #E0E0E0
카드 배경 단색(흰색 권장)

다음 단계

개발자 제공 결제 API와 사용자 선택 기능의 통합을 시작하려면 인앱 통합 및 백엔드 통합에 관한 심층 가이드를 따르세요.

개발자 제공 결제만 제공

이 섹션에서는 Google Play 결제 시스템 사용을 선택할 수 없는 개발자 제공 결제를 사용자에게 제공하는 방법을 설명합니다. API를 사용하기 전에 먼저 다음 사항을 확인하세요.

Google Play Developer API 통합 설정을 준비하시기 바랍니다. 이 설정은 백엔드 통합에서 사용됩니다.

Play Console에서 구성

등록을 완료하고 개발자 제공 결제 API와 통합된 개발자는 Play Console을 통해 개발자 제공 결제 설정을 관리할 수 있습니다.

  • 요건을 충족하는 각 앱의 경우 사용 가능한 각 국가에서 개발자 제공 결제 시스템만(사용자 선택 없음) 제공하도록 선택하거나 선택 해제합니다.
설명용 UI로, 변경될 수 있습니다.

사용자 정보 화면

정보 화면을 통해 사용자는 대상 앱 내에서 개발자 제공 결제 시스템만 제공된다는 사실을 알 수 있습니다. 정보 화면은 개발자 제공 결제가 사용 설정된 후 앱에서 첫 구매를 시작할 때 사용자에게 표시됩니다. 이 메시지는 같은 사용자가 동일한 기기에서 앱으로 후속 구매를 진행할 때는 표시되지 않습니다. 사용자가 기기에서 캐시를 지우는 등의 상황에서는 대화상자가 사용자에게 다시 표시될 수도 있습니다.

다음 단계

개발자 제공 결제 API 통합을 시작하려면 인앱 통합 및 백엔드 통합에 관한 심층 가이드를 따르세요.