getRefundStatus

Cập nhật lần cuối:15/6/2026

API cho phép đối tác gọi để truy vấn tình trạng hoàn tiền của 1 giao dịch hoàn tiền.

API specification

Method	Headers	Endpoint
GET		https://payment-mini.zalo.me/api/refund

Parameters

Object object

Property	Type	Required	Description
appId	string	true	Id định danh của mini app
refundId	string	true	Id của yêu cầu hoàn tiền
mac	string	true	Thông tin chứng thực, xem cách tạo thông tin chứng thực ở dưới

Tạo thông tin chứng thực

data = "appId={appId}&refundId={refundId}&privateKey={privateKey}";
mac = HMAC("HmacSHA256", privateKey, data);

Return Values

Promise <Object data>

Property	Type	Description
returnCode	int	1 : Hoàn tiền giao dịch thành công != 1 : Hoàn tiền không thành công
returnMessage	string	Mô tả thông tin returnCode

Error code

Tham khảo tại đây.