SasS 无人自助售货柜交易接口
1. 简介
提供Server To Server无人自助售货柜交易接口 给服务商(下述描述机构均为服务商) 调用。
注:涉及金额字段,单位均为元
请求地址,请求头信息参看文档: saas公共请求及响应参数-3. 请求公共参数信息
响应头信息参看文档: saas公共请求及响应参数-4. 响应公共参数信息
2.查询接口
2.1 交易查询
介绍:依据商户号以及交易流水号或商户交易流水号(二选一)查询交易信息。
接口地址: /saas/query
Header 参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|---|---|---|---|
| interfaceVersion | String | 是 | 版本号 | 默认值:1.0.0 |
| language | String | 否 | 语言 | 语言(zh_CN,zh_TW,en_US)默认取值:zh_CN |
| interfaceName | String | 是 | 接口名称 | 填写:transaction |
| businessType | String | 是 | 业务类型 | 填写:query |
| orgNo | String | 是 | 机构编号 | |
| orgCertId | String | 是 | 机构密钥证书序列号 | |
| signature | String | 是 | 机构签名 | |
| signMethod | String | 是 | 机构签名方法 | 取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256 |
请求参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
merchant
| Object | 是 | 商户对象信息 | ||||||||||||||||
transaction
| Object | 是 | 交易对象信息 |
Curl请求示例
curl --location '${PAYMENT_DOMAIN}/saas/query' \
--header 'businessType: query' \
--header 'interfaceName: transaction' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: A18VnjMNpXcsW41XDAlkzCXT16V+tNTVdD5/Kp/BHwgJnSHCN6rzaBh9hfm8xQFNNdp0ueb79plOaVzibF5ZLbx7Vy/qYr5iRNq1DZCyHB9XjBRGabLbKfZ/3kRvOrcgRFKy2ZRcAqJVw2J5DryqYTBlYzJZKpq8BbpWzepd/AqsjLSVHGyUJgaDeGeUM1lX52ovJRvSDEt6sTjZt56mOB5Zi+kI3KwawivRe2rdenDDC5LLyJde8+91XCC+hXn+wjXq8eMQJ6n4Wdkyh9Da5j0uwjvTxB6GHAXmWn49dFdSPVOWxjlz33gc2xi7w/oQbecpRrF98Xf52H95QIBwfQ==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
"requestId": "S**************_20250721071251671_06",
"requestTime": "2025-07-21T07:12:51.671+08:00",
"nonceStr": "VTCG6QAxj3YzWwzvuYxIRRNODmk7nTfh",
"data": {
"merchant": {
"merchantNo": "**********"
},
"transaction": {
"transactionNo": "TKE18DD7B12000000843982354104320",
"merchantSerialNo": "MERCHANT_SERIAL_20260128145822"
}
}
}'
响应参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transaction
| Object | 是 | 交易对象 |
响应Headers数据示例:
signature: bka/ln9zgHTen4jblFP84UJPs2a/paEFbeV/+1cMoW8B5pGegHSGc4dZIxh4bD1oOV0W0lwqCnhSPzbvN9Xb2XGSAREK4WsSk4QrV5axK7Eh6gVtK7TOibtM3KnoA77B6iww3R1uuEclWgrvXcwVqDJpNQbm10sJU6OSHY5Q3UlTRr1t+f5+T1lKHjg0w9VY9VBK61Mwzhc+qrySLVD/WnxVVIO95SfA7wkvhRM8L1i/4OWAonSWo0Xmt/l4ALCHPKr0H/splrvPj1tfq6S3ibg8+PhSIt+B5Mtdb6tlx80BdlXD+Wx2swZ5B70kk83dF/KQvsGT6g10PiGCAN6fSw==
orgCertId: ****************************************
signMethod: RSA-SHA256
响应Body数据示例
{
"requestId": null,
"requestTime": null,
"responseTime": "2026-01-28T06:58:23.790+00:00",
"respCode": 200,
"respMsg": "success",
"busCode": null,
"busMsg": null,
"busSubCode": null,
"busSubMsg": null,
"data": {
"transaction": {
"transactionNo": "TKE18DD7B12000000843982354104320",
"orderNo": "10820250722000011211",
"amount": 20.00,
"refundAmount": 10.00,
"payerFee": 0.00,
"payerRefundFee": 0.00,
"payeeFee": 0.00,
"payeeRefundFee": 0.00,
"tipAmount": 0.00,
"currency": "HKD",
"transactionType": "01",
"paymentWay": "01",
"authCode": "467309",
"status": "00",
"responseCode": "200",
"transactionTime": "2025-07-22T04:48:01.000+00:00",
"transactionZoneUTCTime": "2025-07-22T12:48:01.000+08:00",
"transactionZoneId": "Asia/Hong_Kong",
"timeZoneFlag": 0,
"completionTime": "2025-07-22T04:48:02.000+00:00",
"refundFlag": "01",
"revokeFlag": "00",
"authCompleteFlag": "00",
"paymentType": "01",
"paymentSubtype": "03",
"cardFlag": "03",
"cardBrand": "01",
"cardNoDigest": "997a14df7b9a13a216e2e9f2095f9288569847a732b6403378aee27a524a8d9f",
"purseOrderNo": "BANKORDERNO20250910",
"channelTransactionNo": "2025072211287100",
"cardNoMask": "451461******7853"
}
}
}
3.交易接口
3.1 预授权完成
介绍:预授权交易成功后发起预授权完成交易,该接口仅发起预授权完成受理,实际预授权完成状态以异步通知接口为准,参考:4.交易通知
接口地址: /saas/pos
Header 参数
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|---|---|---|---|
| interfaceVersion | String | 是 | 版本号 | 默认值:1.0.0 |
| language | String | 否 | 语言 | 语言(zh_CN,zh_TW,en_US)默认取值:zh_CN |
| interfaceName | String | 是 | 接口名称 | 填写:auth/capture |
| businessType | String | 是 | 业务类型 | 填写:pos |
| orgNo | String | 是 | 机构编号 | |
| orgCertId | String | 是 | 机构密钥证书序列号 | |
| signature | String | 是 | 机构签名 | |
| signMethod | String | 是 | 机构签名方法 | 取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256 |