单笔交易查询接口

本文档定义CHINAPNR支付网关商户接入接口规范，提供接口报文参数说明、示例报文、信息安全解决方案，并给出相关问题说明等，以帮助商户技术人员接入，便于尽快投入使用。
根据PCI-DSS检查要求，正式环境禁止使用低版本的SSL3.0 TLS1.0 TLS1.1等协议,请使用高于TLSv1.2及以上发送请求，推荐使用TLSv1.2

提交参数

请求地址

环境 HTTPS请求地址
测试环境 https://hfgj.testpnr.com/pay/singleTrxQuery.htm
正式环境 https://global.chinapnr.com/pay/singleTrxQuery.htm

协议参数

参数 类型 是否必填 最大长度 描述 示例值
inputCharset String 是 5 字符集,固定值：1
1-UTF-8		 1
signType String 是 2 签名类型，固定值：4
4-RSA加签		 4

业务参数

参数 类型 是否必填 最大长度 描述 示例值
merchantAcctId String 必选 32 会员账号，由我司提供的商户号+01，共13位数字 1001234001101
terminalId String 必选 8 终端号，由我司提供的终端号 999999
orderId string 必填 32 商户提交的原订单号 order20170728120001299
dealId String 可选 32 收单系统交易号，该交易在收单系统对应的交易号 2000003882
signMsg String 必选 2048 签名字符串 参数1={参数1}&参数2={参数2}&……&参数n={参数n}然后进行商户密钥进行加签 
inputCharset={inputCharset}&signType={signType}&merchantAcctId={merchantAcctId}&terminalId={terminalId}&orderId={orderId}&dealId={dealId}
只对非空值的字段进行加签。

返回结果

查询结果会接口同步返回。

返回参数

参数 类型 是否必填 最大长度 描述 示例值
merchantAcctId String 必选 32 会员账号，与提交订单时的保持一致 1001234001101
terminalId String 必选 8 终端号，与提交订单时的保持一致 999999
version String 必选 10 网关版本，与提交订单时一致 3.0
payType String 必选 4 支付方式，与提交订单时一致 00
bankId String 必选 10 银行代码，与提交订单一致 ABC
orderId String 必选 32 商户订单号，与提交订单时一致 order20170728120001299
orderTime String 必选 14 商户订单提交时间，与提交订单时一致 20171117020101
orderCurrency String 必选 3 订单币种，与提交订单时一致 USD
orderAmount Number 必选 12 商户订单金额，与提交订单时一致 10000
dealId String 必选 32 收单系统交易号，该交易在收单系统对应的交易号 20000100
dealTime String 必选 14 交易时间，交易失败时可能为空。收单系统对交易进行处理的时间,格式为：年[4位]月[2位]日[2位]时[2位]分[2位]秒[2位] 20170728120001
payResult String 必选 2 处理结果，10:支付成功 11:支付未成功 10
bankDealId String 可选 64 银行交易号，字符串,可为空
errCode String 可选 8 错误代码，详细请参考错误代码附录 000000
ext1 String 可选 128 扩展字段1，与提交订单时一致 扩展字段1
ext2 String 可选 128 扩展字段2，与提交订单时一致 扩展字段2
queryRespCode String 必选 2 查询结果，S查询成功、F查询失败 S
queryRespMsg String 可选 512 查询返回描述:字符串，可为空
signMsg String 必选 2048 签名字符串，商户需对该字段进行验签。对于所有值不为空的参数及对应值，按照字母顺序组成字符串 DSA：参数1={参数1}&参数2={参数2}&……&参数n={参数n}然后进行支付平台证书加密形成密文后进行2048位的Base64转码。 
merchantAcctId={merchantAcctId}&terminalId={terminalId}&version={version}&payType={payType}&bankId={bankId}&orderId={orderId}&orderTime={orderTime}&orderCurrency={orderCurrency}&orderAmount={orderAmount}&dealId={dealId}&dealTime={dealTime}&payResult={payResult}&bankDealId={bankDealId}&errCode={errCode}&ext1={ext1}&ext2={ext2}&queryRespCode={queryRespCode}&queryRespMsg={queryRespMsg}
根据字母排序（如a**字段放在b**字段前面）验签。

请求示例

请参考具体Demo。  下载地址