交易查询

查询任何交易的当前状态和完整详情 —— 无论该交易是通过结账、S2S 卡还是 iFrame 创建的。

接口地址 (Endpoint): POST /v2/checkout/query
Content-Type: application/json

---

请求 (Request)

字段	类型	是否必填	描述
transactionId	String (ULID)	M	GLODIPAY 交易 ID
signature	String(max:750)	M	RSA-MD5 签名。请参阅 签名

请求示例:

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

---

响应 (Response)

Content-Type: application/json

字段	类型	描述
merchantId	String	商户 ID
transactionId	String	GLODIPAY 交易 ID (ULID)
transactionNumber	String	GLODIPAY 人类可读的交易编号
ref	String	商户的 orderRef
currency	String	ISO 4217 货币代码
amount	Float	发票金额
paidAmount	Float	实际向买家收取的金额（包括买家费用）
settlementAmount	Float	结算给商户的金额
estimationSettlementAt	ISO 8601 datetime	预计结算日期时间
fees	JSON	费用明细。请参阅 fees 对象
status	String	交易状态。请参阅 状态值
statusCode	Number	数字状态码。请参阅 状态码
metadata	JSON	原始会话中的键值对
transactionDocuments	JSON	原始会话中的辅助文档
paymentMethodDetails	JSON	所使用的付款方式。请参阅 paymentMethodDetails 对象
message	String	人类可读的状态消息
descriptor	String	交易描述符
transactionCreatedAt	ISO 8601 datetime	GLODIPAY 系统中的交易创建时间
originalTransactionCreatedAt	ISO 8601 datetime	支付渠道侧的交易创建时间
signature	String	RSA-MD5 签名 —— 使用 GLODIPAY 公钥验证。请参阅 签名

响应示例:

{
  "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"
}

---

注意事项

• 查询响应包含与 IPN 通知 Payload 相同的字段。在未收到 IPN 时，可使用此接口对账付款状态。
• 在信任状态之前，务必验证查询响应中的 signature。
• transactionId 在创建会话时，会包含在结账、S2S 卡和 iFrame API 的响应中。