Method: externaltransactions.refundexternaltransaction

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

Thông 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: applications/{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 hoàn tiền cho giao dịch.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
Trường hợp hợp nhất refund_type. Bắt buộc. Loại giao dịch hoàn tiền bên ngoài. refund_type chỉ có thể là một trong những loại sau:
partialRefund

object (PartialRefund)

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

object (FullRefund)

Hoàn lại toàn bộ số tiền.

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.

Mẫu

Sau đây là một yêu cầu mẫu:

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions/foo:refund' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "partialRefund": { \
      "refundId": "my_refund_id", \
      "refundPreTaxAmount": { \
        "currency": "USD", \
        "priceMicros": "10120000" \
      } \
    }, \
    "refundTime": "2023-10-20T16:43:32.852Z" \
  }'

Sau đây là phản hồi mẫu:

{
  "externalTransactionId": "1234567890123456789012345678901234567890123456789012345678901234",
  "originalPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "1990000"
  },
  "originalTaxAmount": {
    "currency": "USD",
    "priceMicros": "11400000"
  },
  "packageName": "com.example.app",
  "transactionState": "TRANSACTION_CANCELED",
  "transactionTime": "2023-04-01T12:00:00Z",
  "userTaxAddress": {
    "regionCode": "US"
  },
  "createTime": "2023-04-01T11:55:00Z",
  "currentPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "currentTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "testPurchase": {},
  "recurringTransaction": {
    "initialExternalTransactionId": "9876543210987654321098765432109876543210987654321098765432109876",
    "externalSubscription": {
      "subscriptionType": "RECURRING"
    }
  }
}

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 một 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ã nhận dạng duy nhất giúp phân biệt khoản hoàn tiền một phần này. Nếu yêu cầu hoàn tiền thành công, thì các yêu cầu 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à mã riêng biệt cho các khoản hoàn tiền 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 hoàn tiền một phần. Phải nhỏ hơn số tiền còn lại trước thuế 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 giao dịch.