API Tạo yêu cầu hoàn

a. Tổng quan

- Phương thức gửi nhận: POST JSON

- HTTP Request: POST <BASE_URL> /checkout/merchant-request-refund

b. Data Request (Thông tin gửi sang Alepay)

Tên trường (data) Định dạng Bắt buộc Mặc định Mô tả
transactionCode String T - Mã giao dịch trên Alepay
merchantRefundCode String T - Mã hoàn tiền duy nhất do Merchant tạo
refundAmount Double T - Số tiền hoàn (làm tròn đến 1 VND)
reason String F - Lý do hoàn tiền

checksum = SHA-256 (transactionCode + merchantRefundCode + refundAmount + checksumKey)

c. Data Response (Thông tin nhận về từ Alepay)

Tên trường (data) Định dạng Mô tả
transactionCode String Mã giao dịch trên Alepay
merchantRefundCode String Mã hoàn tiền duy nhất do Merchant tạo
orderCode String Mã đơn hàng của Merchant
refundAmount Double Số tiền hoàn (làm tròn đến 1 VND)
reason String Lý do hoàn tiền
refundStatus String Mã trạng thái giao dịch hoàn tiền
checksum String Mã checksum để kiểm tra tính chính xác của dữ liệu:
checksum = SHA-256 (transactionCode + orderCode + refundAmount + merchantRefundCode + checksumKey)
refundTime Long Thời gian hoàn tiền (millisecond)

 

d. Demo API

- Data Request:

  {
      "tokenKey": "SI85PMt00k9SfmIbupQinvHVPCHYUd",
      "data":
      {
          "transactionCode":"ALE00U14P",
          "merchantRefundCode":"ALERF30_API_2602",
          "refundAmount":"300000",
          "reason":"Test Refund"
      },
      "checksum": "7f75ea6f93704b12f12665006d0fe0eecf320df27120ffb412937abc7db1e4f2"
  }

- Data Response:

  {
      "code": "000",
      "message": "Thành công",
      "data": {
          "transactionCode": "ALE00U14P",
          "merchantRefundCode": "ALERF30_API_2602",
          "orderCode": "ALE30_API_1110",
          "refundAmount": "300000",
          "reason": "Test Refund",
          "refundStatus": "222",
          "checksum": "f9863ff32717bcfdd7c1c2a599735b37aae243571867de5b96cf539dc84587ca",
          "refundTime": 1740557126822
      }
  }