Hàm lấy trạng thái chi hộ theo orderId

Hàm cho phép bạn xem trạng thái giao dịch theo orderId, mỗi orderId chỉ kiểm tra được cho một transactionId.

HTTP request

POST {{URL}}/api/v2/disbursement/query-trx

URL

+ Sanbox: http://sb-disbursement.esms.center

+ Production: https://api.vihatsoftware.com

• Content Type: application/json

• Response Type: application/json

curl --location --globoff '{{URL}}/api/v2/disbursement/query-trx' \
--header 'token: {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "orderId":"{{orderId}}",
    "signature":"{{signature}}"
}'
}'

• Cấu trúc body của request:

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
token	string		Bạn sẽ được cung cấp khi sử dụng hàm gen API token.
orderId	string		orderId của khách hàng truyền vào khi thực hiện giao dịch chi hộ.
signature	string		Chữ ký điện tử được tạo từ secretKey theo format bên dưới HmacSHA256(“orderId”)

---

• Response:

{
    "data": {
        "resultCode": "0",
        "message": "Thành công.",
        "transactionId": "141571a8ab5841e9bf692068dc528c2b",
        "channelId": 1,
        "method": 1,
        "amount": 110000,
        "status": 3,
        "timestamp": 1724229987,
        "orderId": "mã-1724229984830",
        "callbackUrl": "https://en9v99k4uwp0k.x.pipedream.net/"
    },
    "code": 0,
    "message": "Success"
}

• Cấu trúc body của response:

Thuộc tính	Mô tả
data	resultCode: Kết quả giao dịch chi hộ message: Thông báo thành công hay thất bại của giao dịch orderId : Giá trị orderId. amount : Số tiền chi hộ. transactionId: Mã giao dịch eSMS trả về. channelId : Kênh chi hộ. method : Hình thức chi hộ. timestamp : Thời gian hòan thành giao dịch status : Trạng thái giao dịch (0: Trạng thái ban đầu, 1:Đang chờ , 2: Đang xử lý , 3: Thành công, -1: Thất bại ) callbackUrl: Link callback của khách hàng
code	Mã lỗi trả về: 0: thành công .
message	Thông báo kết quả lấy trạng thái chi hộ

• Thông tin chi tiết mã lỗi xem ở bảng: esms , momo, zalo