Truy vấn giao dịch
Hợp đồng Endpoint
Truy vấn trạng thái hiện tại và chi tiết đầy đủ của một giao dịch được tạo thông qua các luồng checkout, S2S card hoặc iframe.
POST /v2/checkout/queryapplication/jsonYêu cầu chữ ký
Request
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
transactionId | String (ULID) | M | ID giao dịch GLODIPAY. |
signature | String(max:750) | M | Chữ ký RSA-MD5 được tạo từ thân request. |
Response
| Trường | Kiểu | Mô tả |
|---|---|---|
merchantId | String | ID Merchant. |
transactionId | String | ID giao dịch GLODIPAY. |
transactionNumber | String | Số giao dịch có thể đọc được. |
ref | String | Tham chiếu đơn hàng của Merchant. |
currency | String | Mã tiền tệ ISO 4217. |
amount | Float | Số tiền hóa đơn. |
paidAmount | Float | Số tiền người mua đã trả. |
settlementAmount | Float | Số tiền quyết toán cho merchant. |
estimationSettlementAt | ISO 8601 | Thời gian quyết toán ước tính. |
fees | JSON | Chi tiết phí. |
status | String | Trạng thái giao dịch. |
statusCode | Number | Mã trạng thái dạng số. |
metadata | JSON | Dữ liệu metadata gốc. |
transactionDocuments | JSON | Các tài liệu hỗ trợ gốc. |
paymentMethodDetails | JSON | Chi tiết phương thức thanh toán. |
message | String | Thông báo trạng thái có thể đọc được. |
descriptor | String | Mô tả giao dịch. |
transactionCreatedAt | ISO 8601 | Thời gian tạo trên GLODIPAY. |
originalTransactionCreatedAt | ISO 8601 | Thời gian tạo trên PSP. |
signature | String | Chữ ký phản hồi để xác minh với khóa công khai GLODIPAY. |
Đối tượng fees
| Trường | Kiểu | Mô tả |
|---|---|---|
buyer | Float | Số tiền phí phía người mua. |
seller | Float | Số tiền phí phía merchant. |
rolling | Float | Số tiền dự phòng (rolling reserve). |
operate | Float | Tổng phí vận hành (bộ xử lý + GLODIPAY + đối tác). |
estimationRollingReleaseAt | ISO 8601 | Thời gian ước tính giải phóng dự phòng. |
Đối tượng paymentMethodDetails
| Trường | Kiểu | Mô tả |
|---|---|---|
displayName | String | Nhãn hiển thị phương thức thanh toán. |
group | String | Loại nhóm phương thức thanh toán. |
family | String | Loại họ phương thức thanh toán. |
type | String | Loại phương thức thanh toán (ví dụ: card, googlepay). |
card | JSON | Tùy chọn. Chi tiết cụ thể về thẻ (chỉ dành cho thanh toán bằng thẻ). Bao gồm name, firstSixDigits, lastFourDigits, expiryMonth, expiryYear, type, issuer, funding, v.v. |
Nguồn
Trang này được trích xuất từ Checkout API.