API Kiểm tra và lấy thông tin GD

a. Tổng quan

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

- HTTP Request: POST <BASE_URL> /checkout/get-refund-info

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

checksum = SHA-256 (transactionCode + merchantRefundCode + 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 + merchantRefundCode + refundAmount + checksumKey)
refundTime Long Thời gian hoàn tiền (millisecond)

 

d. Demo API

- Data Request:

  {
      "tokenKey": "SI85PMt00k9SfmIbupQinvHVPCHYUd",
      "data":
      {
          "transactionCode":"ALE00TM4F",
          "merchantRefundCode":"ALERF30_API_1510"
      },
      "checksum": "c2ca7b448e16768418c348ec797de7500444a4a64b5cca306dcd223703e51ad7"
  }

- Data Response:

  {
      "code": "000",
      "message": "Thành công",
      "data": {
          "transactionCode": "ALE00TM4F",
          "orderCode": "ALE30_API_1110",
          "merchantRefundCode": "ALERF30_API_1510",
          "refundAmount": "300000",
          "reason": "Test Refund",
          "refundStatus": "000",
          "refundTime": 1729224231502,
          "checksum": "21743527b1d69d3ccfdddb0955f63a1f494ab1d30160e97df02bee53c39939bc"
      }
  }