山海微信支付接口开发文档

山海微信接口开发文档1. 商户发给网关接口的参数参数名称参数含义可空参数说明customerid 商户ID 否商户在网关系统上的商户号sdcustomno 商户流水号否订单在商户系统中的流水号orderAmount 支付金额否订单支付金额；单位:分(人民币)cardno 支付方式否固定值32noticeurl 通知商户Url 否在网关返回信息时通知商户的地址，该地址不能带任何参数，否则异步通知会不成功backurl 回调Url 否在网关返回信息时回调商户的地址,该地址不能带任何参数sign md5签名否发送给网关的签名字符串,为以上参数加商户在网关系秘钥（key）一起按照顺序MD5加密并转为大写的字符串mark商户自定义信息否商户自定义信息，不能包含中文字符，因为可能编码不一致导致MD5加密结果不一致商户发给网关接口的url范例:website?customerid=customerid&sdcustomno=sdcustomno&orderAmount=orderAmount&cardno=cardno&noticeurl=noticeurl &backurl=backurl&sign=sign&mark=mark注意：(1)website为网关的接受信息网址：/gateway/weixin/weixinpay.asp(2)sign加密时参数要按照顺序，否则加密后无法通过验证,范例：Md5str="customerid="&customerid&"&sdcustomno="&sdcustomno&"&orderAmount="&orderAmount&"&cardno="&cardn o&"&noticeurl=" &noticeurl&"&backurl="&backurl&key示例：(key值为：2s52e2e41s5e1sf2sf5e)Md5str="customerid=123456&sdcustomno=2014060121365446&orderAmount=100&cardno=32&noticeurl=http://xxx.x xx/weixinNotify&backurl=http:// xxx.xxx/payMS/weixinNotify2s52e2e41s5e1sf2sf5e"key 值请联系商务人员获取2. 网关接口返回(noticeurl)给商户的参数参数名称参数含义参数说明state 订单充值状态 1.充值成功 2.充值失败customerid 商户ID 商户注册的时候，网关自动分配的商户IDsd51no 订单在网关的订单号该订单在网关系统的订单号sdcustomno 商户订单号该订单在商户系统的流水号ordermoney 订单实际金额商户订单实际金额单位：（元）cardno 支付类型支付类型，为固定值 32mark 商户自定义信息未启用暂时返回空值sign md5签名字符串发送给商户的签名字符串resign md5二次签名字符串发送给商户的签名字符串des 支付备注描述订单支付成功或失败的系统备注网关发给商户的通知url范例：website?state={state}&customerid={customerid}&sd51no={sd51no}&sdcustomno={sdcustomno}&ordermoney={orde rmoney}&cardno={cardno}&mark={mark}&sign={sign}& resign={resign}&des={des}参数示例：website?state=1&customerid=132456&sd51no=6565565565&sdcustomno=53111111111111&ordermoney=100&cardno=32 12312121212121&mark=51cps&sign=1s31se2e1e2w3132w1&des=aa注：(1).{参数n}为参数n的值(2). website为商户接受通知(回调)地址,对应商户发送给网关Url中的noticeurl参数(3). sign为customerid={customerid}&sd51no={sd51no}&sdcustomno={sdcustomno}&mark={mark}&key={key}进行MD5加密并转为大写的字符串，key为商户在网关系统的密钥示例："customerid=123456&sd51no=654311213214&sdcustomno=54156413215456&mark=weixin&key=2df5s2s" (4). resign为sign={sign}&customerid={customerid}&ordermoney={ordermoney}&sd51no={sd51no}&state={state} &key={key}进行MD5加密并转为大写的字符串，key为商户在网关系统的密钥示例："sign=第一次加密结果&customerid=123456&ordermoney=100&sd51no=654311213214&state=1&key=2df5s2s"1.商户在接受到网关通知时，应该打印出<result>1</result>标签，以供接口程序抓取信息，以便于我们获取是否通知成功的信息，否则订单会显示没有通知商户。

3.支付订单查询接口商户系统在没有收到山海网关异步通知的情况下，可以通过此接查询接口查询商户系统订单状态。

请求方式: POST/GET 户统商系–>山海网关接口地址: /gateway/zx_orderquery.asp提交参数列表字段名变量名类型说明可空商户ID customerid String 商户注册的时候，山海网关自动分配的商户ID 否商户订单号sdcustomno String 该订单在商户系统的流水号否商户自定义信息mark String 商户自定义信息，注意：不能包含中文字符，因为可能编码不一致，导致MD5加密结果不一致是MD5签名sign String customerid="&customerid&"&sdcustomno="&sdcustomno&"&mark="&mark&"&key="&key否返回参数列表（调用订单查询成功，返回的参数）字段名变量名类型说明可空订单充值状态state String（1）0：订单正在处理中1：订单充值成功2：订单充值失败N山海订单号sd51no String 该订单在山海网关系统的订单号N商户流水号sdcustomno String 商户流水号N订单实际金额ordermoney Float 商户订单实际金额单位：（元）NY 商户自定义信息mark String 商户自定义信息，山海支付网关查询返回结果的时候原样返回调用订单查询成功，返回的例子：<?xml version="1.0" encoding="GB2312" ?><fill version="1.0"><items><item name="state" value="1" /><item name="sd51no" value="51ka200909221133271515034815613" /><item name="sdcustomno" value="00909221133271515034815613" /><item name="ordermoney" value="0.01" /><item name="mark" value="shanhai" /></items></fill>返回参数列表（调用订单查询失败，返回参数）字段名变量名类型说明可空订单查询状态state String（1）0：订单查询失败N 错误代码errcode String（4）错误代码N 错误信息errmsg String 错误信息N 商户自定义信息mark String 商户自定义信息，原样返回Y 调用订单查询败失，返回的例子：<?xml version="1.0" encoding="GB2312" ?><fill version="1.0"><items><item name="state" value="0" /><item name="errcode" value="1000" /><item name="errmsg" value="参数不完整" /><item name="mark" value="shanhai" /></items></fill>接口注意事项此种方式查询订单状态是商户可选可不选，建议在山海网关没有异步通知订单结果的情况下使用（注意：此查询接口只能查询商户在当前3天以内的订单结果）。