Chuyển đến nội dung chính

Thực hiện hoàn tiền giao dịch​

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 thành công qua Zalopay.

Request Body required
  • app_id integer required

    ID duy nhất của ứng dụng sẽ được cung cấp sau khi nhà cung cấp đăng ký thành công với Zalopay.

  • m_refund_id string required

    ID hoàn tiền sẽ được ứng dụng tạo ra. Định dạng: yymmdd_appid_xxxxxxxxxx.

  • zp_trans_id string required

    ID giao dịch Zalopay để hoàn tiền

  • amount int64 required

    Số tiền cần hoàn tiền.

  • refund_fee_amount int64

    Phí của giao dịch hoàn tiền. Phí này sẽ được trích ra từ phần tiền người mua hàng nhận lại được từ giao dịch hoàn tiền. Nếu không cần phí hoàn, bạn có thể bỏ qua trường dữ liệu này.

  • timestamp int64 required

    Thời điểm (timestamp) khi đơn hoàn tiền được tạo ra, tính bằng mili giây (ms).

  • description string required

    Lý do hoàn tiền.

  • mac string required

    Chữ ký của yêu cầu hoàn tiền. Nếu không có phí hoàn (refund_fee_amount), HMAC input được tính như sau:

    hmacinput = appid + | + zptransid + | + amount + | + description + | + timestamp

    Trường hợp có phí hoàn, sử dụng công thức sau:

    hmacinput = appid + | + zptransid + | + amount + | + refund_fee_amount + | description + | + timestamp

    Vui lòng tham khảo Truyền dữ liệu an toàn.

Responses

OK

Schema
  • return_code integer

    Mã trạng thái Vui lòng tham khảo mã trạng thái để biết thêm chi tiết.

  • return_message string
  • sub_return_code integer

    Mã trạng thái Vui lòng tham khảo mã trạng thái để biết thêm chi tiết.

  • sub_return_message string
  • refund_id int64
Loading...