Nhảy tới nội dung

createRefund

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.

Đố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.
  • Chỉ admin mới có quyền sử dụng API này.

API specification

MethodHeadersEndpoint
POST"Authorization": Bearer {Your token here}https://payment-mini.zalo.me/api/refund/create

Parameters

Object object

PropertyTypeRequiredDescription
transIdstringtrueMã giao dịch muốn hoàn tiền (mã được trả về khi thanh toán)
amountlongtrueSố tiền muốn hoàn lại cho khách hàng
descriptionstringLý do hoàn tiền

Return Values

Promise<Object data>

PropertyTypeDescription
refundIdstringId của yêu cầu hoàn tiền
returnCodeint
  • 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
returnMessagestringMô tả thông tin returnCode