- Tài nguyên: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- ExternalOfferInitialAcquisitionDetails
- 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 mà sản phẩm trong ứng dụng được bán (ví dụ: "com.some.app"). |
externalTransactionId |
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 |
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 |
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 |
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 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 đượ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 |
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ụ: |
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 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ụ: |
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ỉ người dùng để tính thuế. |
transactionProgramCode |
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 |
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 |
Đây là giao dịch một lần và không thuộc 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 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 |
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 |
Trường | |
---|---|
Trường kết hợp
|
|
initialExternalTransactionId |
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 |
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 |
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 |
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 đị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 ( |
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 |
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 |
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. 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 |
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 |
|
---|---|
|
Tạo 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 tiền cho một giao dịch bên ngoài hiện có. |