Truy vấn giao dịch

Truy vấn trạng thái hiện tại và chi tiết đầy đủ của bất kỳ giao dịch nào — cho dù được tạo qua Checkout, S2S Card hay iFrame.

Endpoint: POST /v2/checkout/query
Content-Type: application/json

---

Yêu cầu (Request)

Trường	Loại	Bắt buộc	Mô tả
transactionId	String (ULID)	M	ID giao dịch của GLODIPAY
signature	String(max:750)	M	Chữ ký RSA-MD5. Xem Chữ ký

Ví dụ yêu cầu:

{
  "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
  "signature": "base64-encoded-signature"
}

---

Phản hồi (Response)

Content-Type: application/json

Trường	Loại	Mô tả
merchantId	String	ID của người bán
transactionId	String	ID giao dịch của GLODIPAY (ULID)
transactionNumber	String	Số giao dịch dễ hiểu của GLODIPAY
ref	String	orderRef của người bán
currency	String	Mã tiền tệ ISO 4217
amount	Float	Số tiền hóa đơn
paidAmount	Float	Số tiền thực tế đã thu từ người mua (bao gồm cả phí người mua)
settlementAmount	Float	Số tiền sẽ được thanh quyết toán cho người bán
estimationSettlementAt	ISO 8601 datetime	Thời gian thanh quyết toán dự kiến
fees	JSON	Phân tách các loại phí. Xem đối tượng fees
status	String	Trạng thái giao dịch. Xem Giá trị trạng thái
statusCode	Number	Mã trạng thái số. Xem Mã trạng thái
metadata	JSON	Các cặp khóa-giá trị từ phiên thanh toán ban đầu
transactionDocuments	JSON	Các tài liệu hỗ trợ từ phiên làm việc ban đầu
paymentMethodDetails	JSON	Phương thức thanh toán đã sử dụng. Xem đối tượng paymentMethodDetails
message	String	Thông báo trạng thái dễ hiểu
descriptor	String	Mô tả giao dịch (descriptor)
transactionCreatedAt	ISO 8601 datetime	Thời gian tạo giao dịch trong hệ thống GLODIPAY
originalTransactionCreatedAt	ISO 8601 datetime	Thời gian tạo giao dịch tại PSP
signature	String	Chữ ký RSA-MD5 — xác minh bằng khóa công khai của GLODIPAY. Xem Chữ ký

Ví dụ phản hồi:

{
  "merchantId": "1100000123",
  "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
  "transactionNumber": "2604-1713100800",
  "ref": "ORDER-001",
  "currency": "USD",
  "amount": 100.00,
  "paidAmount": 105.00,
  "settlementAmount": 95.00,
  "estimationSettlementAt": "2026-04-16T00:00:00+00:00",
  "fees": {
    "buyer": 5.00,
    "seller": 5.00,
    "rolling": 2.00,
    "operate": 3.00,
    "estimationRollingReleaseAt": "2026-05-14T00:00:00+00:00"
  },
  "status": "successful",
  "statusCode": 6,
  "paymentMethodDetails": {
    "displayName": "Credit / Debit Card",
    "group": "card",
    "family": "card",
    "type": "card",
    "card": {
      "name": "John Doe",
      "firstSixDigits": "411111",
      "lastFourDigits": "1111",
      "expiryMonth": "01",
      "expiryYear": "30",
      "type": "visa"
    }
  },
  "metadata": { "orderId": "12345" },
  "message": null,
  "descriptor": "GLODIPAY*ORDER-001",
  "transactionCreatedAt": "2026-04-14T10:00:00+00:00",
  "originalTransactionCreatedAt": "2026-04-14T10:00:01+00:00",
  "signature": "base64-encoded-rsa-signature"
}

---

Lưu ý

• Phản hồi truy vấn chứa các trường tương tự như payload thông báo IPN. Hãy sử dụng nó để đối soát trạng thái thanh toán khi không nhận được IPN.
• Luôn xác minh signature trong phản hồi truy vấn trước khi tin tưởng vào trạng thái.
• transactionId được trả về trong các phản hồi API Checkout, S2S Card và iFrame khi phiên thanh toán được tạo.