REST Resource: externaltransactions

Tài nguyên: ExternalTransaction

Thông tin chi tiết về một giao dịch bên ngoài.

Biểu diễn dưới dạng 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)
  },

  // 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.
}
Trường
packageName

string

Chỉ có đầu ra. Tên tài nguyên của giao dịch bên ngoài. Tên gói của ứng dụng nơi bán sản phẩm trong ứng dụng (ví dụ: "com.some.app").
externalTransactionId

string

Chỉ có đầu ra. Mã của giao dịch này. Tất cả các mã giao dịch trong cùng một tên gói phải là duy nhất. Đặt khi tạo giao dịch bên ngoài.
originalPreTaxAmount

object (Price)

Bắt buộc. Số tiền giao dịch ban đầu (trước thuế). Số tiền này thể hiện số tiền trước thuế ban đầu được thông báo cho Google trước khi khoản tiền hoàn lại được áp dụng.
originalTaxAmount

object (Price)

Bắt buộc. Số tiền thuế ban đầu. Số tiền thuế này thể hiện số tiền thuế ban đầu được thông báo cho Google trước khi khoản hoàn thuế được áp dụng.
currentPreTaxAmount

object (Price)

Chỉ có đầu ra. Số tiền giao dịch hiện tại (trước thuế). Số tiền này thể hiện số tiền trước thuế hiện tại, bao gồm cả mọi khoản tiền hoàn lại có thể đã được áp dụng cho giao dịch này.
currentTaxAmount

object (Price)

Chỉ có đầu ra. Số tiền thuế hiện tại. Số tiền này thể hiện số tiền thuế hiện tại, bao gồm cả mọi khoản tiền hoàn lại có thể đã được áp dụng cho giao dịch này.
testPurchase

object (ExternalTransactionTestPurchase)

Chỉ có đầu ra. Nếu bạn đặt chính sách này, thì giao dịch này là một giao dịch mua thử nghiệm. Google sẽ không tính phí đối với giao dịch thử nghiệm.
transactionTime

string (Timestamp format)

Bắt buộc. Thời điểm hoàn tất giao dịch.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo giao dịch này. Đây là thời điểm Google nhận được thông báo về giao dịch này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

Chỉ có đầu ra. Trạng thái hiện tại của giao dịch.
userTaxAddress

object (ExternalTransactionAddress)

Bắt buộc. Địa chỉ của người dùng để tính thuế.
Trường hợp transaction_type. Loại giao dịch đã được thực hiện. transaction_type chỉ có thể là một trong những trạng thái sau:
oneTimeTransaction

object (OneTimeExternalTransaction)

Đây là giao dịch một lần chứ không phải của gói thuê bao.
recurringTransaction

object (RecurringExternalTransaction)

Giao dịch này nằm trong một chuỗi giao dịch định kỳ.

ExternalTransactionTestPurchase

Loại này không có trường.

Đại diện cho một giao dịch được thực hiện bằng tài khoản thử nghiệm. Google sẽ không tính phí các giao dịch này.

OneTimeExternalTransaction

Đại diện cho giao dịch một lần.

Biểu diễn dưới dạng JSON 
{
  "externalTransactionToken": string
}
Trường
externalTransactionToken

string

Chỉ nhập. Được cung cấp trong cuộc gọi đến Create. Được truy xuất từ ứng dụng khi quy trình thanh toán thay thế bắt đầu hoạt động.

RecurringExternalTransaction

Đại diện cho một giao dịch thuộc một chuỗi thanh toán định kỳ. Đây có thể là gói thuê bao hoặc sản phẩm tính phí một lần có nhiều khoản thanh toán (chẳng hạn như đặt hàng trước).

Biểu diễn dưới dạng 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.
}
Trường

Trường hợp source.

source chỉ có thể là một trong những trạng thái sau:
initialExternalTransactionId

string

Mã giao dịch bên ngoài của giao dịch đầu tiên trong chuỗi giao dịch định kỳ này. Ví dụ: đối với một gói thuê bao, đây sẽ là mã giao dịch của khoản thanh toán đầu tiên. Bắt buộc khi tạo giao dịch định kỳ bên ngoài.
externalTransactionToken

string

Chỉ nhập. Được cung cấp trong cuộc gọi đến Create. Được truy xuất từ ứng dụng khi quy trình thanh toán thay thế bắt đầu hoạt động. Chỉ bắt buộc đối với giao dịch mua ban đầu.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Chỉ nhập. Được cung cấp trong cuộc gọi đến Create. Bạn chỉ được sử dụng tính năng này khi chuyển gói thuê bao từ báo cáo thủ công hằng tháng sang báo cáo tự động.
Trường hợp product_details. Bắt buộc. Thông tin chi tiết về sản phẩm trong giao dịch định kỳ bên ngoài. product_details chỉ có thể là một trong những trạng thái sau:
externalSubscription

object (ExternalSubscription)

Thông tin chi tiết về gói thuê bao bên ngoài.
otherRecurringProduct

object (OtherRecurringProduct)

Thông tin chi tiết về một sản phẩm giao dịch bên ngoài định kỳ không thuộc bất kỳ danh mục cụ thể nào khác.

ExternalTransactionProgram

Biểu thị chương trình giao dịch bên ngoài mà người dùng gặp phải để hoàn tất giao dịch.

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Chương trình giao dịch chưa được chỉ định. Không được sử dụng.
USER_CHOICE_BILLING Phương thức thanh toán do người dùng chọn (trong đó người dùng có thể chọn giữa phương thức thanh toán do nhà phát triển quản lý trong Google Play Billing).
ALTERNATIVE_BILLING_ONLY Chỉ dành cho hệ thống thanh toán thay thế, trong đó người dùng chỉ có thể sử dụng phương thức thanh toán do nhà phát triển quản lý.

ExternalSubscription

Thông tin chi tiết về gói thuê bao bên ngoài.

Biểu diễn dưới dạng JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
Trường
subscriptionType

enum (SubscriptionType)

Bắt buộc. Loại gói thuê bao bên ngoài.

SubscriptionType

Các loại gói thuê bao bên ngoài.

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED Chưa xác định, không sử dụng.
RECURRING Đây là gói thuê bao định kỳ, trong đó người dùng sẽ bị tính phí theo chu kỳ thanh toán.
PREPAID Đây là gói thuê bao trả trước mà người dùng sẽ trả trước.

OtherRecurringProduct

Loại này không có trường.

Thông tin chi tiết về một sản phẩm giao dịch bên ngoài định kỳ không thuộc bất kỳ danh mục cụ thể nào khác.

TransactionState

Trạng thái của giao dịch đang được thực hiện.

Enum
TRANSACTION_STATE_UNSPECIFIED Trạng thái giao dịch chưa xác định. Không được sử dụng.
TRANSACTION_REPORTED Giao dịch này đã được báo cáo thành công cho Google.
TRANSACTION_CANCELED Giao dịch đã được hoàn tiền đầy đủ.

ExternalTransactionAddress

Địa chỉ của người dùng cho giao dịch bên ngoài.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
Trường
regionCode

string

Bắt buộc. Mã vùng gồm hai chữ cái dựa trên ISO-3166-1 Alpha-2 (mã vùng của Liên Hợp Quốc).
administrativeArea

string

Không bắt buộc. Đơn vị hành chính cấp cao nhất của quốc gia/khu vực. Chỉ bắt buộc đối với các giao dịch ở Ấn Độ. Giá trị hợp lệ là "ANDAMAN AND NICORA.

Phương thức

createexternaltransaction

 Tạo một giao dịch bên ngoài mới.

getexternaltransaction

 Lấy một giao dịch bên ngoài hiện có.

refundexternaltransaction

 Hoàn tiền hoặc hoàn lại một phần cho một giao dịch bên ngoài hiện có.