RefundPurchase/v0001 (Tài liệu Steamworks)

Tài liệu Steamworks

RefundPurchase/v0001

Tài liệu về Steamworks > Tính năng > Dịch vụ kho đồ Steam > Hệ thống kinh tế Steam > RefundPurchase/v0001

Hàm này được Steam gọi sau khi người dùng gửi yêu cầu hoàn tiền và đội hỗ trợ Steam chấp thuận. Việc triển khai sẽ gỡ bỏ vật phẩm đã mua khỏi tài khoản người dùng. Thường chỉ gọi một lần cho mỗi yêu cầu hoàn tiền, nhưng có thể sẽ gọi nhiều hơn một lần cho cùng một đơn hàng, ví dụ như khi Steam không đọc được phản hồi trong lần đầu thực hiện lệnh gọi. Nên triển khai sao cho cả hai lệnh gọi đều thành công.

Gọi bởi: Hoàn tiền Steam

Phương thức HTTP: POST

Tham số:

Tên	Loại	Bắt buộc	Mô tả
key	string	✔	Đây là "Mã máy chủ asset" mà bạn cung cấp trong Thiết lập hệ thống kinh tế Steam của ứng dụng trên trang đối tác.
appid	uint32	✔	AppID 32-bit của ứng dụng liên kết với đơn hàng. Đây sẽ là AppID của trò chơi.
steamid	uint64	✔	SteamID 64-bit của người dùng mua hàng.
orderid	uint64	✔	ID 64-bit độc nhất cho đơn hàng. Chính là ID đơn hàng được cung cấp trong lệnh gọi ISteamMicroTxn/InitTxn.
force	bool	✔	True nếu đội hỗ trợ Steam đã xem xét giao dịch, thấy vài vật phẩm được đánh dấu là không thể hoàn trả, nhưng vẫn quyết định hoàn tiền.

Trả về

Kết quả có được từ phương thức này nên được mã hóa theo định dạng JSON.

Phản hồi:

result
- success - True nếu phương thức trả về thành công. Nếu máy chủ asset trả về false, nên đặt chuỗi giải thích lý do trong error.
- error - Một chuỗi mô tả lý do lệnh gọi này thất bại. Thông điệp sẽ được ghi lại trong nhật ký lỗi, có thể tìm thấy tại thẻ Kinh tế trong bảng Quản trị ứng dụng trên trang web Steamworks.

Kết quả ví dụ

{ "result": { "success": true } }