1. 公共接口规范

1.1. 接口列表及请求地址

对应接口	接口代码（transCode）	请求地址
【个人会员实名及绑卡（申请）】	1010	测试：http://116.228.64.55:28082/yst-service-api/tm/handle 生产：http://116.228.64.55:28082/yst-service-api/tx/handle
【个人会员实名及绑卡（确认）】	1011
消费申请	2085	测试：http://116.228.64.55:28082/yst-service-api/tx/handle 生产：https://ibsapi.allinpay.com/yst-service-api/tx/handle
退款申请	2294
订单关闭	2295
查询车牌服务开通信息	4007
创建停车入场	4008
停车入场状态变更通知	4009
订单状态查询	3001	测试：http://116.228.64.55:28082/yst-service-api/tq/handle 生产：https://ibsapi.allinpay.com/yst-service-api/tq/handle
订单详情查询	3002
终端信息管理	4001	测试：http://116.228.64.55:28082/yst-service-api/tm/handle 生产：https://ibsapi.allinpay.com/yst-service-api/tm/handle
对账文件下载	4002	测试：http://116.228.64.55:28082/yst-service-api/file/download 生产：https://ibsapi.allinpay.com/yst-service-api/file/download

字段	字段类型	必填	字段名称	说明
appId	String	是	云商通二代分配的应用ID	如上送服务商应用ID，验证服务商证书
spAppId	String	否	云商通二代分配的服务商应用ID
transCode	String	是	接口代码
format	String	否	仅支持JSON	json
charset	String	是	请求使用的编码格式，utf-8	UTF-8
signType	String	是	商户生成签名字符串所使用的签名算法类型	比如：SM3withSM2
sign	String	是	商户请求参数的签名串
transDate	String	是	发送请求的日期，格式"yyyyMMdd"	20240202
transTime	String	是	请求时间	141333
version	String	是	调用的接口版本	1.0
bizData	String	是	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

字段	字段类型	必填	字段名称	说明
code	String	是	调用结果返回码	00000-成功
msg	String	是	调用结果返回码描述
sign	String	是	商户请求参数的签名串
bizData	String	是	返回参数的集合，最大长度不限，除公共参数外所有返回参数都必须放在这个参数中传递，具体参照各产品快速接入文档

字段	字段类型	必填	参数名称	说明
notifyTime	Date	是	通知时间	格式为yyyy-MM-dd HH:mm:ss
notifyId	String	是	通知校验ID
charset	String	是	编码格式	编码格式， utf-8
version	String	是	接口版本	调用的接口版本1.0
signType	String	是	签名类型	签名算法类型，如：SM3WithSM2
sign	String	是	签名	签名串
appId	String	是	应用ID	分配给开发者的应用ID
spAppId	String	否	云商通二代分配的服务商应用ID
transCode	String	是	接口代码	与原交易接口代码一致
bizData	String	是	业务参数的集	通知参数的集合，最大长度不限，除公共参数外所有通知参数都必须放在这个参数中传递，具体参照各产品快速接入文档

1、订单类结果通知规则

（1）当后台通知地址返回http的状态为200时，则认为通知成功，将停止通知。

（2）对于交易时效非常高的场景，建议商户建立主动查询机制【查询订单状态】。

（3）订单后台通知条件：

2、通知重发规则

（1）同样的通知可能会多次发送给接收方系统。接收方系统必须能够正确处理重复的通知。

（2）后台通知交互时，如果接收方反馈给通知方的应答不符合规范或超时（链接保持5s），通知方服务器会不断重发通知，直到收到接收方正确的反馈或超过6小时。一般情况下，6小时以内完成7次通知（通知的间隔频率一般是：5s/15s/1m/10m/30m/1h/6h）,但通知方不保证通知最终一定能成功。

（3）在订单状态不明或者没有收到支付结果通知的情况下，建议接收方主动调用【交易结果查询】确认订单状态。

获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign、signType字段，剔除值为空的参数，并按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。

将签名参数（sign）使用 base64 解码为字节码串。
调用验签函数：使用各自语言对应的SM3WithSM2签名验证函数，传入待验签字段、服务商或者客户公钥、签名内容(经过base64解码)进行验签，根据返回结果判定是否验签通过。

客户端与服务端之间传递敏感信息，请使用SM4 对称加密算法进行加密后传输。

SM4加密：将传入的密钥（secretKey）的字节数组作为因子通过SHA1PRNG生产一个64位的随机源，构造出原始密钥，通过ECB模式对明文数据进行加密，加密后的字节码转为16进制大写输出。

独立部署一个api服务，加解密调用此服务，方法见附件：