支付接口参数【请求方式:GET或POST均可】【如遇问题可尝试用html表单提交参数】
参数名称 | 参数含义 | 必填 | 说明 |
---|---|---|---|
fxid | 商务号 | 是 | 唯一号,由{#$sitename#}提供 |
fxddh | 商户订单号 | 是 | 仅允许字母或数字类型,不超过22个字符,不要有中文 |
fxdesc | 商品名称 | 是 | utf-8编码 |
fxfee | 支付金额 | 是 | 请求的价格(单位:元) 可以0.01元 |
fxnotifyurl | 异步通知地址 | 是 | 异步接收支付结果通知的回调地址,通知url必须为外网可访问的url,不能携带参数。 |
fxbackurl | 同步通知地址 | 是 | 支付成功后跳转到的地址,不参与签名。 |
fxpay | 请求类型 {#volist name="jiekou" id="n" #} 【{#$n.jkname#}:{#$n.jkstyle#}】 {#/volist#} | 是 | 请求支付的接口类型。 |
fxnotifystyle | 异步数据类型 | 否 | 异步返回数据的类型,默认1 返回数据为表单数据(Content-Type: multipart/form-data),2 返回post json数据。 |
fxattch | 附加信息 | 否 | 原样返回,utf-8编码 |
fxsmstyle | 扫码模式 | 否 | 用于扫码模式(sm),仅带sm接口可用,默认0返回扫码图片,为1则返回扫码跳转地址。 |
fxbankcode | 银行类型 | 否 | 用于网银直连模式,请求的银行编号,参考银行附录,仅网银接口可用。 |
fxfs | 反扫付款码数字 | 否 | 用于用户被扫,用户的付款码数字,仅反扫接口可用。 |
fxuserid | 快捷模式绑定商户id | 否 | 用于识别用户绑卡信息,仅快捷接口可用。 |
fxsign | 签名【md5(商务号+商户订单号+支付金额+异步通知地址+商户秘钥)】 | 是 | 通过签名算法计算得出的签名值。 |
fxip | 支付用户IP地址 | 是 | 用户支付时设备的IP地址 |
支付申请示例(请用脚本语言模拟如下提交方式)
<form id="Form1" name="Form1" method="post" action="http://localhost:8001/Pay"> <input type="hidden" name="fxid" value='2017100'/> <input type="hidden" name="fxddh" value='1531392180374'/> <input type="hidden" name="fxdesc" value='test'/> <input type="hidden" name="fxfee" value='10'/> <input type="hidden" name="fxattch" value='mytest'/> <input type="hidden" name="fxnotifyurl" value='http://localhost:8001/notifyUrl.php'/> <input type="hidden" name="fxbackurl" value='http://localhost:8001/backUrl.php'/> <input type="hidden" name="fxpay" value='wxsm'/> <input type="hidden" name="fxip" value='126.155.2.36'/> <input type="hidden" name="fxsign" value='3990af9dbffc4e0ac6d307aee9b034d8'/> </form> |
支付接口返回【数据格式:json】
参数 | 参数含义 | 必须 | 说明 |
---|---|---|---|
status | 状态 | 是 | 状态【1代表正常】【0代表错误】 |
payurl | 支付链接 | 是 | 正常状态下返回支付跳转路径,跳转到该路径即可支付 |
error | 错误信息 | 是 | 错误状态下返回错误信息utf-8编码数据 |
支付申请返回示例
{ "status":1, "payurl":"http://localhost:8001/Index/Index/qrcode?url=weixin%3A%2F%2Fwxpay%2Fbizpayurl%3Fpr%3D1qznay9&w=150&k=a7f356ce6e0bd96cde2e404b9b272ad4" } |
同步(GET)/异步(POST)【数据格式:默认 表单数组(Content-Type: multipart/form-data)(java请用request.getInputStream获取参数)】
返回参数【成功失败均返回数据,请判断订单状态,请以异步数据为准】
参数 | 参数含义 | 必须 | 说明 |
---|---|---|---|
fxid | 商务号 | 是 | 唯一号,由{#$sitename#}提供 |
fxddh | 商户订单号 | 是 | 平台返回商户提交的订单号 |
fxorder | 平台订单号 | 是 | 平台内部生成的订单号 |
fxdesc | 商品名称 | 是 | utf-8编码 |
fxfee | 支付金额 | 是 | 支付的价格(单位:元) |
fxattch | 附加信息 | 是 | 原样返回,utf-8编码 |
fxstatus | 订单状态 | 是 | 【1代表支付成功】 |
fxtime | 支付时间 | 是 | 支付成功时的时间,unix时间戳。 |
fxsign | 签名【md5(订单状态+商务号+商户订单号+支付金额+商户秘钥)】 | 是 | 通过签名算法计算得出的签名值。 |
【商户接收数据后需要返回success代表通知成功】
订单查询【提交参数GET或POST均可】
参数 | 参数含义 | 必须 | 说明 |
---|---|---|---|
fxid | 商务号 | 是 | 唯一号,由{#$sitename#}提供 |
fxddh | 商户订单号 | 是 | 平台返回商户提交的订单号 |
fxaction | 商户查询动作 | 是 | 商户查询动作,这里填写【orderquery】 |
fxsign | 签名【md5(商务号+商户订单号+商户查询动作+商户秘钥)】 | 是 | 通过签名算法计算得出的签名值。 |
订单查询返回【数据格式:json】
参数 | 参数含义 | 必须 | 说明 |
---|---|---|---|
fxid | 商务号 | 是 | 唯一号,由{#$sitename#}提供 |
fxstatus | 状态 | 是 | 支付状态【1正常支付】【0支付异常】 |
fxddh | 商户订单号 | 是 | 平台返回商户提交的订单号 |
fxorder | 平台订单号 | 是 | 平台内部生成的订单号 |
fxdesc | 商品名称 | 是 | utf-8编码 |
fxfee | 支付金额 | 是 | 支付的价格(单位:元) |
fxattch | 附加信息 | 是 | 原样返回,utf-8编码 |
fxtime | 支付时间 | 是 | 支付成功时的时间,unix时间戳。 |
fxsign | 签名【md5(订单状态+商务号+商户订单号+支付金额+商户秘钥)】 | 是 | 通过签名算法计算得出的签名值。 |
error | 错误信息 | 是 | 错误状态下返回错误信息utf-8编码数据 |
银行附录
银行名称 | 银行编号 |
---|---|
{#$n.bankname#} | {#$n.bankcode#} |