➕API Check Transaction

API kiểm tra trạng thái của giao dịch thuộc ecommerce.

POST

https://<vietqr-host>/<basepath>/api/ecommerce-transactions/check-order

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Required	Description
bankAccount	String	Yes	Số tài khoản ngân hàng.
type	String	Yes	Check by orderId: 0 Check by referenceNumber: 1
value	String	Yes	Giá trị làorderId nếu type = 0 Giá trị làreferenceNumber nếu type = 1
checkSum	String	Yes	Chuỗi mã hóa MD5 của tổ hợp: (bankAccount + username)

Response

200

[
    {
        "referenceNumber": "mã_giao_dịch",
        "orderId": "mã_đơn_hàng",
        "amount": số_tiền_giao_dịch,
        "content": "nội_dung_thanh_toán",
        "transType": "giao_dịch_đến_hoặc_đi",
        "status": phân_loại_trạng_thái_giao_dịch_theo_số,
        "type": phân_loại_giao_dịch_theo_số,
        "timeCreated": tem_thời_gian_tạo_mã_QR,
        "timePaid": tem_thời_gian_thanh_toán,
        "terminalCode": "mã_điểm_bán",
        "note": "ghi_chú_giao_dịch",
        "refundCount": số_lần_đã_hoàn_tiền_thuộc_giao_dịch_này,
        "amountRefunded": số_tiền_đã_hoàn_tiền_thuộc_giao_dịch_này
    }
]

Giá trị trả về của type:

• 0: Giao dịch từ hệ thống VietQR.

• 2: Giao dịch ngoài hệ thống VietQR.

• 6: Giao dịch hoàn tiền.

Giá trị trả về của status:

• 0: Giao dịch chờ thanh toán.

• 1: Giao dịch đã thanh toán.

• 2: Giao dịch hết hạn thanh toán.

400

{
    "status": "FAILED",
    "message": "mã_lỗi_và_mô_tả_lỗi"
}