接口规范

请求

1、商户提交给平台的请求可以以POST和GET的方式提交，当以GET方式请求时各参数的参数值需做URL编码，编码字符集UTF-8，当以POST方式请求时各参数的参数值不需要做URL编码。

2、签名的数据根据接口的定义，参见签名机制。

3、各请求参数的参数值的前后不允许出现空白符，否则将影响签名的正确性。

响应

响应的内容写在HTTP响应标签的CONTENT属性中，该内容中各数据项以字符“&”隔开。CONTENT必须大写，并且其内容中不能出现“”的字符，每个数据项内不允许出现“&”符号。因为在HTML中可能有多个标签存在，此标签通过其NAME属性判断，其属性值为MobilePayPlatform，其格式如下：

签名的数据根据接口的定义，将需要签名的数据项以“key1=value1&key2=value2&key3=value3….”的格式做为签名对象进行签名，在签名对象末尾不能包含“&”符号。

各响应参数的参数值的前后不允许出现空白符，否则将影响签名的正确性。

消息报文示例

请求消息(商户->平台)

个人充值请求(商户->平台)

http://pay.soopay.net/spay/pay/payservice.do?account_id=61000025459&amount=1&charset=UTF-8&gate_id=CMB&mer_date=20140918&mer_id=7000998&notify_url=http%3A%2F%2Fwww.xxx.com%2Fmer_recharge_person.jsp&order_id=2014091801&pay_type=B2CDEBITBANK&res_format=HTML&ret_url=http%3A%2F%2Fwww.xxx.com%2Fmer_recharge_person.jsp&service=mer_recharge_person&sign_type=RSA&user_id=UB201408211722200000000000274391&version=1.0&sign=ehn%2FTVDMMrUWtvsBF5Ev0Uz8SviP2gpWtRRnDH6gUlfmkjCSKtrxD8Blfup6xwDnctjgyqdNNdCH67NH4sUPT7JOfhwzJTA3XzeYLPtt6duBjhyXmGGDilx9lQufZO5aQtZpBxw%2BO%2FOU3Xs8A7JsuBjtJwynk5OZyApijVG6M%2B0%3D

此请求为页面跳转，所以无同步响应

通知消息(平台->商户)

前台通知

http://www.xxx.com/mer_recharge_person.jsp?service=recharge_notify&ret_code=0000&mer_check_date=20140918&com_amt=1&trade_no=1409181409024494&mer_id=7000998&sign_type=RSA&ret_msg=%E5%85%85%E5%80%BC%E6%88%90%E5%8A%9F&order_id=2014091801&sign=xHZhkXBgSpHjdEgRACGUBRZg51hC3bWYyohRrn52QEK9SWgyFtlJ%2Fd%2BtTKy%2B%2BlSrgbA5goo2mIVyScXi6%2B53qKaK1zmhSaiF152ftmI8mcMlBlWpHbbjATDilVDF70ik7B%2F0M3e5QN5rkWdvIUZjyiOSMiX8ODzcGerbwrWaw2Y%3D&mer_date=20140918&version=4.0

后台通知

http://www.xxx.com/mer_recharge_person.jsp?balance=00000000000002&com_amt=1&mer_check_date=20140918&mer_date=20140918&mer_id=7000998&order_id=2014091801&ret_code=0000&ret_msg=%E5%85%85%E5%80%BC%E6%88%90%E5%8A%9F&service=recharge_notify&trade_no=1409181409024494&version=4.0&sign=lbKkoUiTu3IwYTdjiN%2BwuDBlSFB2mpi4HCeRmE3PZkuKTv2Z1%2F9%2Ff9BUSufJNmupEPz8W0z5KVpGBcCOqOA0HubP9jNJxvsfbpDinOQ6Rne9N5MzJrlU4iHyMScu%2F76ZBTjIe9FOQQMzuL8KH6CtHwInVUuoU3UC%2Fj7Z59V22ME%3D&sign_type=RSA

通知消息的响应(商户->平台)

商户的通知，商户侧需要对通知消息进行如下响应