REST Resource: externaltransactions

리소스: ExternalTransaction

외부 거래의 세부정보입니다.

JSON 표현 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
필드
packageName

string

출력 전용입니다. 외부 거래의 리소스 이름입니다. 인앱 상품이 판매된 애플리케이션의 패키지 이름입니다 (예: 'com.some.app').
externalTransactionId

string

출력 전용입니다. 이 거래의 ID입니다. 동일한 패키지의 모든 거래 ID는 고유해야 합니다. 외부 거래 생성 시 설정됩니다.
originalPreTaxAmount

object (Price)

필수 항목입니다. 세금이 부과되기 전 원래 거래 금액입니다. 환불이 적용되기 전에 Google에 원래 고지된 세전 금액을 나타냅니다.
originalTaxAmount

object (Price)

필수 항목입니다. 원래 세금 금액입니다. 환불이 적용되기 전에 Google에 원래 고지된 세금 금액을 나타냅니다.
currentPreTaxAmount

object (Price)

출력 전용입니다. 세금이 부과되기 전 현재 거래 금액입니다. 이 거래에 적용되었을 수 있는 환불을 포함해 최근 세전 금액을 나타냅니다.
currentTaxAmount

object (Price)

출력 전용입니다. 최근 세금 금액입니다. 이 거래에 적용되었을 수 있는 환불을 포함해 최근 세금 금액을 나타냅니다.
testPurchase

object (ExternalTransactionTestPurchase)

출력 전용입니다. 설정된 경우 이 거래는 테스트 구매였습니다. Google에서는 테스트 거래에 비용을 청구하지 않습니다.
transactionTime

string (Timestamp format)

필수 항목입니다. 거래가 완료된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
createTime

string (Timestamp format)

출력 전용입니다. 거래가 생성된 시간입니다. Google에 거래가 통지된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
transactionState

enum (TransactionState)

출력 전용입니다. 거래의 현재 상태입니다.
userTaxAddress

object (ExternalTransactionAddress)

필수 항목입니다. 세금 계산을 위한 사용자 주소입니다.
transactionProgramCode

integer

선택사항입니다. 파트너 프로그램에 참여하는 대상 앱의 서비스 수수료를 결정하는 데 사용되는 거래 프로그램 코드입니다. Play 미디어 경험 프로그램 (https://play.google.com/console/about/programs/mediaprogram/)에 참여하는 개발자는 개발자 제공 결제 거래를 보고할 때 프로그램 코드를 제공해야 합니다. 자격 요건을 충족하는 개발자인 경우 이 입력란을 설정하는 방법에 관해 자세히 알아보려면 BDM에게 문의하세요. 참고: 이 필드는 외부 제품 거래에 사용할 수 없습니다.
통합 필드 transaction_type. 수행된 거래의 유형입니다. transaction_type은 다음 중 하나여야 합니다.
oneTimeTransaction

object (OneTimeExternalTransaction)

일회성 거래이며 정기 결제에 포함되지 않습니다.
recurringTransaction

object (RecurringExternalTransaction)

이 거래는 반복되는 일련의 거래에 포함됩니다.

ExternalTransactionTestPurchase

이 유형에는 필드가 없습니다.

테스트 계정으로 수행된 거래를 나타냅니다. Google은 이 거래에 요금을 청구하지 않습니다.

OneTimeExternalTransaction

일회성 거래를 나타냅니다.

JSON 표현 
{
  "externalTransactionToken": string
}
필드
externalTransactionToken

string

입력 전용입니다. 생성 호출 중 제공됩니다. 개발자 제공 결제 절차가 시작되면 클라이언트로부터 가져옵니다.

RecurringExternalTransaction

반복되는 일련의 결제에 포함된 거래를 나타냅니다. 정기 결제이거나 여러 건의 결제가 포함된 일회성 제품 (예: 선주문)일 수 있습니다.

JSON 표현 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
필드

통합 필드 source.

source는 다음 중 하나여야 합니다.
initialExternalTransactionId

string

반복되는 일련의 거래 중 첫 번째 거래의 외부 거래 ID입니다. 예를 들어 정기 결제의 경우 첫 결제의 거래 ID가 됩니다. 반복적 외부 거래를 생성할 때 필요합니다.
externalTransactionToken

string

입력 전용입니다. 생성 호출 중 제공됩니다. 개발자 제공 결제 절차가 시작되면 클라이언트로부터 가져옵니다. 첫 구매 시에만 필요합니다.
migratedTransactionProgram

enum (ExternalTransactionProgram)

입력 전용입니다. 생성 호출 중 제공됩니다. 수동 월간 보고에서 자동 보고로 정기 결제를 이전할 때만 사용해야 합니다.
통합 필드 product_details. 필수 항목입니다. 반복되는 외부 거래의 제품 세부정보입니다. product_details은 다음 중 하나여야 합니다.
externalSubscription

object (ExternalSubscription)

외부 정기 결제의 세부정보입니다.
otherRecurringProduct

object (OtherRecurringProduct)

기타 특정 카테고리에 속하지 않는 반복적 외부 거래의 세부정보입니다.

ExternalTransactionProgram

사용자가 거래를 완료하기 위해 거친 외부 거래 프로그램을 나타냅니다.

열거형
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED 거래 프로그램이 지정되어 있지 않습니다. 사용되지 않음.
USER_CHOICE_BILLING 사용자가 Google Play 결제와 개발자 관리 결제 사이에 선택할 수 있는 경우의 사용자 선택 결제입니다.
ALTERNATIVE_BILLING_ONLY 사용자가 개발자-관리자 결제만 사용할 수 있는 경우 개발자 제공 결제만 해당합니다.

ExternalSubscription

외부 정기 결제의 세부정보입니다.

JSON 표현 
{
  "subscriptionType": enum (SubscriptionType)
}
필드
subscriptionType

enum (SubscriptionType)

필수 항목입니다. 외부 정기 결제의 유형입니다.

SubscriptionType

외부 정기 결제의 유형입니다.

열거형
SUBSCRIPTION_TYPE_UNSPECIFIED 지정되어 있지 않아 사용하지 않습니다.
RECURRING 결제 주기마다 사용자에게 요금이 부과되는 반복적 정기 결제입니다.
PREPAID 사용자가 미리 결제하는 선불 정기 결제입니다.

OtherRecurringProduct

이 유형에는 필드가 없습니다.

기타 특정 카테고리에 속하지 않는 반복적 외부 거래의 세부정보입니다.

TransactionState

이루어진 거래의 상태입니다.

열거형
TRANSACTION_STATE_UNSPECIFIED 지정되지 않은 거래 상태입니다. 사용되지 않음.
TRANSACTION_REPORTED 거래가 성공적으로 Google에 보고되었습니다.
TRANSACTION_CANCELED 거래가 완전히 환불 처리되었습니다.

ExternalTransactionAddress

외부 거래를 위한 사용자의 주소입니다.

JSON 표현 
{
  "regionCode": string,
  "administrativeArea": string
}
필드
regionCode

string

필수 항목입니다. ISO-3166-1 Alpha-2에 따른 두 글자 지역 코드입니다 (UN 지역 코드).
administrativeArea

string

선택사항입니다. 국가/지역의 최상위 수준 관리 하위 분류입니다. 인도에서 이루어지는 거래에만 필요합니다. 유효한 값은 'ANDAMAN AND NICOBAR ISLANDS', 'ANDHRA PRADESH', 'ARUNACHAL PRADESH', 'ASSAM', 'BIHAR', 'CHANDIGARH', 'CHHATTISGARH', 'DADRA AND NAGAR HAVELI', 'DADRA AND NAGAR HAVELI AND DAMAN AND DIU', 'DAMAN AND DIU', 'DELHI', 'GOA', 'GUJARAT', 'HARYANA', 'HIMACHAL PRADESH', 'JAMMU AND KASHMIR', 'JHARKHAND', 'KARNATAKA', 'KERALA', 'LADAKH', 'LAKSHADWEEP', 'MADHYA PRADESH', 'MAHARASHTRA', 'MANIPUR', 'MEGHALAYA', 'MIZORAM', 'NAGALAND', 'ODISHA', 'PUDUCHERRY', 'PUNJAB', 'RAJASTHAN', 'SIKKIM', 'TAMIL NADU', 'TELANGANA', 'TRIPURA', 'UTTAR PRADESH', 'UTTARAKHAND', 'WEST BENGAL'입니다.

메서드

createexternaltransaction

 새 외부 거래를 만듭니다.

getexternaltransaction

 기존 외부 거래를 가져옵니다.

refundexternaltransaction

 기존 외부 거래를 환불하거나 부분 환불합니다.