Powered by GitBook

U付

数据接口规范

请求

  1. 商户提交给平台的请求可以以POST和GET的方式提交，当以GET方式请求时各参数的参数值需做URL编码，编码字符集UTF-8，当以POST方式请求时各参数的参数值不需要做URL编码。
  2. 签名的数据根据接口的定义，参见附录签名机制。
  3. 各请求参数的参数值的前后不允许出现空白符，否则将影响签名的正确性。

请求数据格式：（以5.1接口请求请求参数为例，采用get方式请求）

https://pay.soopay.net/spay/pay/payservice.do?amount=1&amt_type=RMB&card_holder=CUMwWwD8oWAzZVfaNoTG%2Ba46LF8h6MZ6Xur%2FT4E4SKt0%2B%2FRqu3%2FknVGlXQCf2N2PFwWPVo6NgVqzdAhSsQg122v8WUMrjRBmlRMbcStlHC%2FpgYwTAejrzp78TYtFrKWh%2FkU%2BT6KcE0WlrWUdMHeqpMDVO9rt9ScR32ZSL2EGyU8%3D&card_id=ItDTE5MFBaPZ5z0J0wKGnHnn6HjUuWx9QfcfdEsCN8jAy%2Fv7fy0G1gPJQrIOB%2BaqcuMRIisHsrTZQKOmMEuUGkfDkXgsnSHHzqymMHgXfz2BVIhhPnN3dSt9VSXI2ZIdLLGMML5gvMTxL0%2F2l%2BrbxFVWYmeoCSBm6cbcdP2PH80%3D&charset=UTF-8&cvv2=wMaMidrC5k5EmzJdKHIbh3nYJyPKPNk%2BtRjvRFNedFvOuHSHQp9ikXx8ZxcLD%2Bb2WRUXSEpcOrO5z%2FIIbDl78YLoZHTotyP3UFKsQFMpXeaPlDddyiHnX4E0QLsq438KgcU6OL8IEMVHUw17OM7rFXhVlNaOUXPJTM%2B0E5OqMnE%3D&identity_code=wn8DZ%2F5PAdSP1M4SB3HF8FJHGMYklMDDFVoSLUktuXmLkriEeFuTzFgB%2Bz9%2F%2B3LnyjexspQ0tcNDPrz6eK8Ev6ZOrywJPZIlmxsYeZ7eeRu1vFVdDk%2B5IXfg6naMMm%2Bge488vNceDRd%2BzBl36nVgReTz6rN1sWsewn%2BqoLNPdu4%3D&identity_type=IDENTITY_CARD&media_id=15001052294&media_type=MOBILE&mer_date=20130821&mer_id=6374&notify_url=http%3A%2F%2F219.143.210.70%3A80%2Ftestpay%2Ftest%2Fnotify0000V4.jsp&order_id=10603833412&pay_type=CREDITCARD&service=credit_direct_pay&sign_type=RSA&valid_date=hCBn9iyg66W1EoBnNw%2FbCbCqP0rQd63L36Nnn%2BofiUXOyGFFlXhG2zQqqwBMDtWzC%2FzH2VTDS9YG%2Bi%2Fv9cesPxHisuVDdqSRw3RMJlGerd52U4R2PwZIrf3zPa1lNFhatq66Mk62sc8WuZPsAoJwuuVeEZf8mtFUn%2B%2FHf8QZu74%3D&version=4.0&sign=id74I7giIkzdYZ2Q51UQa6VwS29sOpUx8ljOo4wQe9%2FICMRxlDHmL9Vyveus1MRj0QCFfUVMKYI9aI1M7h2zNXF39P0NOtull5%2FJZK4FVbqtr6deeF1T4KyHPF%2BO0uFti4zW78aiAEqNtA6Hd72nFwa06j489vOITovNcZgTgLE%3D

请求数据签名对象：

amount=1&amt_type=RMB&card_holder=CUMwWwD8oWAzZVfaNoTG+a46LF8h6MZ6Xur/T4E4SKt0+/Rqu3/knVGlXQCf2N2PFwWPVo6NgVqzdAhSsQg122v8WUMrjRBmlRMbcStlHC/pgYwTAejrzp78TYtFrKWh/kU+T6KcE0WlrWUdMHeqpMDVO9rt9ScR32ZSL2EGyU8=&card_id=ItDTE5MFBaPZ5z0J0wKGnHnn6HjUuWx9QfcfdEsCN8jAy/v7fy0G1gPJQrIOB+aqcuMRIisHsrTZQKOmMEuUGkfDkXgsnSHHzqymMHgXfz2BVIhhPnN3dSt9VSXI2ZIdLLGMML5gvMTxL0/2l+rbxFVWYmeoCSBm6cbcdP2PH80=&charset=UTF-8&cvv2=wMaMidrC5k5EmzJdKHIbh3nYJyPKPNk+tRjvRFNedFvOuHSHQp9ikXx8ZxcLD+b2WRUXSEpcOrO5z/IIbDl78YLoZHTotyP3UFKsQFMpXeaPlDddyiHnX4E0QLsq438KgcU6OL8IEMVHUw17OM7rFXhVlNaOUXPJTM+0E5OqMnE=&identity_code=wn8DZ/5PAdSP1M4SB3HF8FJHGMYklMDDFVoSLUktuXmLkriEeFuTzFgB+z9/+3LnyjexspQ0tcNDPrz6eK8Ev6ZOrywJPZIlmxsYeZ7eeRu1vFVdDk+5IXfg6naMMm+ge488vNceDRd+zBl36nVgReTz6rN1sWsewn+qoLNPdu4=&identity_type=IDENTITY_CARD&media_id=15001052294&media_type=MOBILE&mer_date=20130821&mer_id=6374&notify_url=http://219.143.210.70:80/testpay/test/notify0000V4.jsp&order_id=10603833412&pay_type=CREDITCARD&service=credit_direct_pay&sign_type=RSA&valid_date=hCBn9iyg66W1EoBnNw/bCbCqP0rQd63L36Nnn+ofiUXOyGFFlXhG2zQqqwBMDtWzC/zH2VTDS9YG+i/v9cesPxHisuVDdqSRw3RMJlGerd52U4R2PwZIrf3zPa1lNFhatq66Mk62sc8WuZPsAoJwuuVeEZf8mtFUn+/Hf8QZu74=&version=4.0

响应

  1. 响应的内容写在HTTP响应标签的CONTENT属性中，该内容中各数据项以字符“&”隔开。CONTENT必须大写，并且其内容中不能出现“<”和“>”的字符，每个数据项内不允许出现“&”符号。因为在HTML中可能有多个标签存在，此标签通过其NAME属性判断，其属性值为MobilePayPlatform，其格式如下：
  2. 签名的数据根据接口的定义，将需要签名的数据项以“key1=value1&key2=value2&key3=value3….”的格式做为签名对象进行签名，签名对象要求严格按照接口规范里的参数从上到下的顺序组装并且在签名对象末尾不能包含“&”符号。
  3. 各响应参数的参数值的前后不允许出现空白符，否则将影响签名的正确性。

响应数据格式：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <META NAME="MobilePayPlatform" CONTENT="amount=1&amt_type=RMB&goods_id=&media_id=15001052294&media_type=MOBILE&mer_date=20130821&mer_id=6374&mer_priv=&order_id=10603833412&pay_date=20130821&pay_seq=000040506243&pay_type=CREDITCARD&ret_code=0000&ret_msg=支付成功&settle_date=20130821&sign_type=RSA&trade_no=1308211031075493&trade_state=TRADE_SUCCESS&version=4.0&sign=j/R+Qb241gqu9Xb8uS7de8Rr01djTNw/fpLvHuWcZ9kIBLIx80iLnRJQfPr3BOb4b+EAA4KmpGtYvXBgCNDiWxUa8SYu8r0mgQpDICDEDghFswrSwVo3LGgo64+oOL10ZIkGGDQJYrPZ5IT/p4lxU4DezzUhuZMTiBubCUZYod8=">
  </head>
  <body>
  </body>
</html>

其他

  1. 除了发送给商户的交易结果通知的URL是商户通过下订单从接口（notifyUrl、）中传来的以外，其它接口商户通过接收平台请求URL不同的参数来区分不同的交易。
  2. 以交易结果通知接口为例：

请求数据格式：

http://219.143.210.70:80/testpay/test/notify0000V4.jsp?amount=1&amt_type=RMB&charset=UTF-8&error_code=0000&media_id=15001052294&media_type=MOBILE&mer_date=20130821&mer_id=6374&order_id=10603833412&pay_date=20130821&pay_seq=000040506243&pay_type=CREDITCARD&service=pay_result_notify&settle_date=20130821&trade_no=1308211031075493&trade_state=TRADE_SUCCESS&version=4.0&sign=BvDLiO8viouy3%2FycwnW2%2BH%2BCoQNcTVPbhJ4l6ED8zrW1hdnG1KbCdrNmK5wc1oB6AC%2FuDiB%2FkZg9DzOT18nR7pqktq8xaUilfXXzO9AGj42X3G8cWmohhI78loNsjCSln%2FgXvLV%2BDa5mIpYNWTejsA6lfg5AsWgx1nXpAkGKzyg%3D&sign_type=RSA

请求数据签名对象：

amount=1&amt_type=RMB&charset=UTF-8&error_code=0000&media_id=15001052294&media_type=MOBILE&mer_date=20130821&mer_id=6374&order_id=10603833412&pay_date=20130821&pay_seq=000040506243&pay_type=CREDITCARD&service=pay_result_notify&settle_date=20130821&trade_no=1308211031075493&trade_state=TRADE_SUCCESS&version=4.0

响应数据格式：

 <META NAME="MobilePayPlatform" CONTENT="mer_date=20130821&mer_id=6374&order_id=10603833412&ret_code=0000&ret_msg=测试商户结果通知响应数据&sign_type=RSA&version=4.0&sign=fFDl6GT/4v3cBRs3k2S9I7n9VKaRmujHvkZ1OkMoKrrKbzppBRo0j41H8oZsy3VfGRWCTWzLFuEKHaDeOdfjJKfNGDzR5XVvKk5FbHZTIl+b+BvWB67PMZgRBVplxqdE9WCPB+8l3AqHJffAI0bdQFPBFN1xkyrjxuWNPWwh1F0=" />

响应数据签名对象：

mer_date=20130821&mer_id=6374&order_id=10603833412&ret_code=0000&ret_msg=测试商户结果通知响应数据&version=4.0