Method: externaltransactions.refundexternaltransaction

Hoàn tiền hoặc hoàn tiền một phần cho 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

Các 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: application/{packageName}/externalTransaction/{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.
}
Các trường
refundTime

string (Timestamp format)

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

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".
Trường nhóm refund_type. Bắt buộc. Loại hoàn tiền 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)
  }
}
Các trường
refundId

string

Bắt buộc. 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 yêu cầu hoàn tiền thành công thì các lần hoàn tiền tiếp theo có cùng mã nhận dạng sẽ không thành công. Phải là duy nhất trên các khoản tiền hoàn lại của 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. Số tiền còn lại trước thuế của giao dịch phải ít hơn.

FullRefund

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

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