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)
  },
  "transactionProgramCode": integer,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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 mà sản phẩm trong ứng dụng được bán (ví dụ: "com.some.app").

externalTransactionId

string

Chỉ có đầu ra. Mã của giao dịch này. Tất 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 khi trừ thuế. Số tiền này thể hiện số tiền trước thuế được thông báo ban đầu cho Google trước khi mọi 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 này thể hiện số tiền thuế được thông báo ban đầu cho Google trước khi áp dụng khoản tiền hoàn lại.

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 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 được đặt, giao dịch này là một giao dịch mua thử nghiệm. Google sẽ không tính phí 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""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ỉ người dùng để tính thuế.

transactionProgramCode

integer

Không bắt buộc. Mã chương trình giao dịch, dùng để giúp xác định phí dịch vụ cho các ứng dụng đủ điều kiện tham gia chương trình đối tác. Nhà phát triển tham gia Chương trình trải nghiệm nội dung đa phương tiện của Play (https://play.google.com/console/about/programs/mediaprogram/) phải cung cấp mã của chương trình khi báo cáo các giao dịch liên quan đến hệ thống thanh toán thay thế. Nếu bạn là nhà phát triển đủ điều kiện, vui lòng liên hệ với BDM của bạn để biết thêm thông tin về cách thiết lập trường này. Lưu ý: Trường này không dùng được cho giao dịch chào bán bên ngoài.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

Không bắt buộc. Thông tin chi tiết về lần đầu tiên người dùng/thiết bị hoàn tất một giao dịch sử dụng ưu đãi bên ngoài. Không bắt buộc đối với những giao dịch chỉ được thực hiện bằng phương thức thanh toán do người dùng chọn hoặc hệ thống thanh toán thay thế.

Trường kết 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 đây:
oneTimeTransaction

object (OneTimeExternalTransaction)

Đây là giao dịch một lần và không thuộc 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 nào.

Biểu thị 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í những 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.

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à một gói thuê bao hoặc sản phẩm tính phí một lần với 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 kết hợp source.

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

initialExternalTransactionId

string

Mã giao dịch bên ngoài của giao dịch đầu tiên của 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 bên ngoài định kỳ.

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. 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 chế độ này khi di 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 kết 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 đây:
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 định kỳ bên ngoài 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 trải qua để 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 dịch vụ thanh toán do nhà phát triển quản lý trên 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 Không 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í vào mỗi chu kỳ thanh toán.
PREPAID Đây là gói thuê bao trả trước, theo đó người dùng thanh toán trước.

OtherRecurringProduct

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

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

TransactionState

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

Enum
TRANSACTION_STATE_UNSPECIFIED Trạng thái giao dịch chưa được chỉ định. Không được sử dụng.
TRANSACTION_REPORTED Giao dịch đã đượ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. Phân khu 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 Độ.

ExternalOfferInitialAcquisitionDetails

Thông tin chi tiết về lần đầu tiên người dùng/thiết bị hoàn tất một giao dịch sử dụng ưu đãi bên ngoài.

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

string

Bắt buộc. Mã giao dịch bên ngoài của giao dịch mua hoàn tất đầu tiên do người dùng thực hiện.

Phương thức

createexternaltransaction

Tạo 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 tiền cho một giao dịch bên ngoài hiện có.