- Tài nguyên: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- Phương thức
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 ( |
Trường | |
---|---|
packageName |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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ụ: |
createTime |
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ụ: |
transactionState |
Chỉ có đầu ra. Trạng thái hiện tại của giao dịch. |
userTaxAddress |
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 |
Đây là giao dịch một lần chứ không phải của gói thuê bao. |
recurringTransaction |
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 |
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 |
Trường | |
---|---|
Trường hợp
|
|
initialExternalTransactionId |
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 |
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 |
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 |
Thông tin chi tiết về gói thuê bao bên ngoài. |
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 ( |
Trường | |
---|---|
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 |
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 |
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 |
|
---|---|
|
Tạo một giao dịch bên ngoài mới. |
|
Lấy một giao dịch bên ngoài hiện có. |
|
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ó. |