支付接口

支付接口参数【请求方式: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编码数据

银行附录

{#volist name="bank" id="n" #} {#/volist#}
银行名称 银行编号
{#$n.bankname#} {#$n.bankcode#}