createRefund

Cập nhật lần cuối:24/8/2026

API cho phép đối tác hoàn tiền toàn phần hoặc từng phần của 1 giao dịch thanh toán với ZaloPay hoặc Momo.

Đối với API này, sẽ không được tích hợp sẵn trong Payment SDK. Đơn vị kinh doanh cần chủ động xây dựng phương án gọi API này để thực hiện hoàn tiền.

Lưu ý

• Quy tắc hoàn tiền dựa vào các quy tắc hoàn tiền của đối tác thanh toán.

API specification

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

Parameters

Object object

Property	Type	Required	Description
appId	string	true	Id định danh của mini app
transId	string	true	Mã giao dịch muốn hoàn tiền (mã được trả về khi thanh toán)
amount	long	true	Số tiền muốn hoàn lại cho khách hàng
description	string		Lý do 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}&transId={transId}&amount={amount}&description={description}&privateKey={privateKey}";
mac = HMAC("HmacSHA256", privateKey, data);

Return Values

Promise <Object data>

Property	Type	Description
refundId	string	Id của yêu cầu hoàn tiền
returnCode	int	1 : Hoàn tiền giao dịch thành công < 1 : Hoàn tiền thất bại, cần thực hiện lại giao dịch > 1 : Đang hoàn tiền, gọi getRefundStatus api để lấy trạng thái cuối cùng
returnMessage	string	Mô tả thông tin returnCode

Error code

Tham khảo tại đây.