Đến nội dung
BankGatewayBankGateway
Console ↗
↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Kiểm tra trạng thái đơn ▾
Tài liệu›Cổng Thanh Toán (Checkout)›Kiểm tra trạng thái đơn
Phiên bản:v1.0.5 (Chính thức)

Kiểm tra trạng thái đơn

Truy vấn trạng thái đơn thanh toán QR từ Backend (PENDING, PAID, EXPIRED, CANCELLED).

GET/api/v1/payment-gateway/checkout/:idHeader: X-API-Key

Tham số xác thực (Query hoặc Header)

Tham sốBắt buộcMô tả
merchantId / X-Merchant-IdCóMerchant ID của cửa hàng.
signature / X-SignatureCóHMAC-SHA256 hex của chuỗi "${merchantId}|${sessionId}" ký bằng Secret Key.
Response 200 OK
{
  "success": true,
  "data": {
    "sessionId": "pay_8f3a19c0...",
    "merchantId": "BGW_A1B2C3D4",
    "orderId": "DH_10001",
    "paymentCode": "BGW9A4F1C",
    "amount": 50000,
    "paidAmount": 50000,
    "status": "PAID",
    "paidAt": "2026-11-16T15:20:00.000Z"
  }
}
Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗