Method: externaltransactions.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ó.

Yêu cầu HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên của giao dịch bên ngoài sẽ được hoàn tiền. Định dạng: ứng dụng/{packageName}/externalTransactions/{externalTransaction}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
Trường
refundTime

string (Timestamp format)

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

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" và "2014-10-02T15:01:23.045123456Z".
Trường kết hợp refund_type. Bắt buộc. Loại tiền hoàn lại cho giao dịch bên ngoài. refund_type chỉ có thể là một trong những trạng thái sau đây:
partialRefund

object (PartialRefund)

Hoàn tiền một phần.
fullRefund

object (FullRefund)

Hoàn tiền toàn bộ.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của ExternalTransaction.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/androidpublisher

PartialRefund

Hoàn tiền một phần cho giao dịch.

Biểu diễn dưới dạng JSON 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
Trường
refundId

string

Bắt buộc. Một mã nhận dạng duy nhất giúp phân biệt khoản tiền hoàn lại một phần này. Nếu việc hoàn tiền thành công, các lần hoàn tiền tiếp theo có cùng mã số sẽ không thành công. Phải riêng biệt trong các khoản tiền hoàn lại cho một giao dịch riêng lẻ.
refundPreTaxAmount

object (Price)

Bắt buộc. Số tiền trước thuế của khoản tiền hoàn lại một phần. Phải nhỏ hơn số tiền trước thuế còn lại của giao dịch.

FullRefund

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

Hoàn lại toàn bộ số tiền còn lại của một giao dịch.