订单查询接口

功能概述

商户通过杰易收订单查询接口查询汇元通平台的订单状态,并且通过主动查询订单来获知订单信息。

接口地址

https://apis.geoswift.com/cp/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在汇元通系统的唯一身份标识,商户完成汇元通系统注册后可登录商户后台商户服务查看。 M
partnerId 服务商Id varchar(9) 服务商编号 C
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。汇元通系统已付或撤销的订单,商户平台不能以相同的订单号再次提交 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

以上参数值中不能包含以下特殊字符’”&<>()

参数示例

{ "merchantId": "G90008005", "requestId": "16242538053223", "hmac": "ZU7z5v20to5gc3oChsrwA7fPiyCqTtDkbhLge34FtRc2vva9aCOr58r8uf+yYiWpvzl 7hRba6QGQne/kLJ2/73b8Tgl2AZOc8MO7roi5IZuj8/BkvoHBhU3lEY7dHf0Hq6Of4xYYb/QSN iU3lVMi85hM+oCMDsnYWmbymLT0UiccqCnjYqii49TwoPc64LbUBO/grJc0X+tSQouzLeUtvtf 9Rt0NpjZuKIeggIWSRlOkJN/gSFRW2zFhWIMUyOYFMuLlk0DnzmIeKMGQ5BBMQYRrX0 AgDbubwrebU+h1Cuewd6J2nfIM311yw1AC/kH8dXcByM2iWTLukVfimer+GA==" }

订单查询返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户在汇元通系统的唯一身份标识,商户完成汇元通系统注册后可登录商户后台商户服务查看。
partnerId 服务商ID 服务商编号
requestId 订单号 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。汇元通系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。
bankRequestNumber 真实银行流水号 请求银行流水号
serialNumber 交易流水号 汇元通系统交易流水号
totalRefundCount 已退款次数 已退款次数
totalRefundAmount 已退款金额 已退款金额,当退款币种为 JPY、KRW、VND 时,已退款金额以元为单位,其他币种以分单位,1元=100分
orderAmount 订单金额 订单金额,当订单币种为 JPY、KRW、VND 时,订单金额以元为单位,其他币种以分单位,1元=100分
orderCurrency 订单币种 见货币列表
settlementAmount 结算金额 结算金额,当结算币种为 JPY、KRW、VND 时,结算金额以元为单位,其他币种以分单位,1 元=100 分
settlementCurrency 结算币种 见货币列表
status 支付状态 CANCEL 取消
SUCCESS 成功
FAILED 失败
INIT 初始化
PROCESSING 处理中
exchangeRate 汇率 小数点后保留6位
feeAmount 手续费 手续费金额,当手续费币种为 JPY、KRW、VND 时,手续费金额以元为单位,其他币种以分单位,1 元=100 分
feeCurrency 手续费币种 见货币列表
gatewayType 网关类型 ALL 混合
DEBIT 借记卡
CREDIT 贷记卡
支付方式为银联在线支付时返回
completeDate Time 完成时间 支付完成时间
paymentModeCode 支付方式 ONLINE_PAY-ALI_PAY-P2P 支付宝 web 支付-直连
ONLINE_PAY-UNION_PAY-P2P 银联在线支付-直连
SCANCODE-WEIXIN_PAY-P2P 微信扫码支付-直连
APP-ALI_PAY-P2P 支付宝 APP 支付-直连
APP-WEIXIN_PAY-P2P 微信 APP 支付-直连
SCANCODE-WEIXIN_PAY 微信扫码支付-非直连
MINIAPPS-WEIXIN_PAY-P2P 微信小程序支付-直连
remark 备注 备注
needReview 是否需要核查 true 是
false 否
errorMessage 错误信息 错误信息
responseStatus 请求状态 SUCCESS 成功
FAILED 失败
ERROR 错误
hmac 参数签名 汇元通生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "totalRefundCount": "0", "serialNumber": "2c9980727a2c6c68017a2d1795490029", "orderCurrency": "CNY", "needReview": "true", "remark": "", "responseStatus": "SUCCESS", "paymentModeCode": "ONLINE_PAY-UNION_PAY-P2P", "orderAmount": "110", "settlementCurrency": "CNY", "merchantId": "G90008005", "requestId": "16242538053223", "totalRefundAmount": "0", "status": "PROCESSING", "hmac": "GV8JdY9YORLVjrn5cPvzH5kPS0uH/39OheEV3d2V/upqyAuI9qYGITb7C7YZrV K3xxIDUBfmNep7CpE9sIX/RhXV1FPvy6Hzh4nm5xb8hp1JNS/8/l8KazZNw9BAyFY3dfKd1R W4HOzRO38shUAdkZ2wc7EelieJv5xxqYQ1kfofeOboT7LdSi9Bn+uPrkBR/aZ1oUbpfJ1untbn9 2AYq24i9P6DXUEw0nzYQZ9K26O/046TQn3kZz+C1ArMr7CKcPj/JpbytJdm7v0mEfSS7jdcwi HW5+4yGtY4wC6aoZEr6dgsHpoOO5GdOkJ3QIgWZSYG5XbWuZHHxElyPHOF8A==" }