REST Resource: purchases.voidedpurchases

Tài nguyên: VoidedPurchase

Tài nguyên VoidedPurchase cho biết một giao dịch mua đã bị huỷ/hoàn tiền/hoàn tiền.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Trường
kind

string

Loại này đại diện cho một đối tượng mua hàng vô hiệu trong dịch vụ androidpublisher.
purchaseToken

string

Mã thông báo xác định duy nhất một giao dịch mua hàng một lần hoặc gói thuê bao. Để xác định riêng các giao dịch gia hạn gói thuê bao, hãy sử dụng orderId (có từ phiên bản 3 của API).
purchaseTimeMillis

string (int64 format)

Thời gian thực hiện giao dịch mua, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống (ngày 1 tháng 1 năm 1970).
voidedTimeMillis

string (int64 format)

Thời gian huỷ/hoàn tiền/hoàn trả giao dịch mua, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống (ngày 1 tháng 1 năm 1970).
orderId

string

Mã đơn đặt hàng xác định duy nhất một giao dịch mua hàng một lần, giao dịch mua gói thuê bao hoặc giao dịch gia hạn gói thuê bao.
voidedSource

integer

Bên khởi tạo giao dịch mua vô hiệu, các giá trị có thể có là: 0. Người dùng 1. Nhà phát triển 2. Google
voidedReason

integer

Lý do khiến giao dịch mua bị vô hiệu, các giá trị có thể là: 0. Khác 1. Không muốn dùng sản phẩm nữa 2. Not_received 3. Bị lỗi 4. Accidental_purchase 5. Gian lận 6. Friendly_fraud 7. Hoàn tiền 8. Unacknowledged_purchase
voidedQuantity

integer

Số lượng bị vô hiệu do hoàn tiền một phần theo số lượng. Bạn chỉ có thể trả lại các giao dịch mua bị vô hiệu hoá có hoàn tiền một phần theo số lượng khi includeQuantityBasedPartialRefund được đặt thành true.

Phương thức

list

 Liệt kê các giao dịch mua đã bị huỷ, hoàn tiền hoặc hoàn tiền.

Mã lỗi

Các thao tác của tài nguyên này sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Mô tả Độ phân giải
400 invalidValue Bạn đã cung cấp một giá trị không hợp lệ trong yêu cầu. Lỗi này thường xảy ra khi mã thông báo mua hàng bị lỗi hoặc không hợp lệ. Hãy sửa giá trị trường không hợp lệ trong nội dung hoặc tham số yêu cầu dựa trên tài liệu tham khảo API.
400 required Yêu cầu thiếu một trường hoặc tham số bắt buộc. Tham khảo tài liệu API để đảm bảo bạn đã thêm tất cả các trường và tham số bắt buộc.
403 userInsufficientPermission Người dùng không có đủ quyền để thực hiện thao tác được yêu cầu. Đảm bảo người dùng được xác thực có các quyền cần thiết trong Google Play Console. Hãy xem phần Sử dụng tài khoản dịch vụ để biết thêm thông tin.
404 notFound Không tìm thấy tài nguyên được yêu cầu. Xác minh rằng các giá trị nhận dạng (ví dụ: mã thông báo giao dịch mua, tên gói, mã sản phẩm, mã thuê bao) là chính xác.
409 concurrentUpdate Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật đồng thời. Thử lại yêu cầu với thời gian đợi luỹ thừa. Tránh sửa đổi đồng thời cùng một tài nguyên.
5xx Generic error Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.