对接前置工作

一句话概括：想用什么支付方式,您需要有对应的收款账号，然后配置到支付FM后台对应位置，最后技术对接我们接口。如果你的网站后台有支付FM的插件或 易支付系列的插件，可以不需要开发对接API，配置对应接口参数就可以。

1. 请亲爱的您要耐心看文档，文档为我们精心编写，可以解决您99%遇到的问题，文档有图文对照操作更快捷。
2. 请先看下支付方式效果说明，了解您想用且能用的支付方式的顾客支付效果。
3. 根据对接步骤完成相应的支付方式的收款号配置。

SDK下载

PHP版本SDK微盘下载：https://share.weiyun.com/E2B4ZoBO
QQ群下载：366959204

页面跳转支付

此接口可用于用户前台直接发起支付，使用form表单跳转或拼接成url跳转。

URL地址：【用户中心】查看到的【V2接口地址】后拼接 submit.php

请求方法：GET/POST 推荐POST，不容易被劫持或屏蔽
参数传递：Query
Content-Type：application/x-www-form-urlencoded

POST数据示例：pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sign={签名字符串}&sign_type=MD5

请求参数说明

URL地址：【用户中心】查看到的【V2接口地址】，一般有些系统的接口地址配置时候不用带/，如果请求失败，请去掉【V2接口地址】后的 / 或 【V2接口地址】后拼接 submit.php

请求方式：POST 或 GET（推荐POST，不容易被劫持或屏蔽）

POST接口支付

此接口可用于服务器后端发起支付请求，会返回JSON数据格式，自行解析展示数据中的支付链接。

URL地址：在支付FM商户后台【用户中心】处可查看到的“V2接口地址”后拼接mapi.php

请求方法：POST
参数传递：Query
Content-Type：application/x-www-form-urlencoded

POST数据示例：pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sign={签名字符串}&sign_type=MD5

请求参数说明

返回结果（json）：

MD5签名算法

KEY 对应支付FM用户中心的 接入密钥
1、将发送或接收到的所有参数按照参数名ASCII码从小到大排序（a-z），sign、sign_type、和空值不参与签名！ 2、将排序后的参数拼接成URL键值对的格式，例如 a=b&c=d&e=f，参数值不要进行url编码。 3、再将拼接好的字符串与商户密钥KEY进行MD5加密得出sign签名参数，sign = md5 ( a=b&c=d&e=f + KEY ) （注意：+ 为各语言的拼接符，不是字符！），md5结果为小写。

参数拼接示例：

sign:money=1&name=【A0125】&notify_url=https://www.zhifux.com/success.txt&out_trade_no=38329329329121&pid=442130427265040384&return_url=https://www.baidu.com&type=alipay072c320169c1c4043277c8746c26050f   
sign的MD5结果:134d9c7103b5534ea72935542c9e4a31

JAVA签名函数示例：

 public static String signed(String key, Map<String, Object> paramMap) {
        String signStr = "";
        for (Map.Entry<String, Object> m : paramMap.entrySet()) {
            if("sign_type".equals(m.getKey()) || "sign".equals(m.getKey())) {
                continue;
            }
            signStr += m.getKey() + "=" + m.getValue() + "&";
        }
        // 去掉最后一个 &
        signStr = signStr.substring(0, signStr.length() - 1);
        // 最后拼接上KEY
        signStr += key;
        System.out.println(signStr);
        // 转为MD5
        return new Digester(DigestAlgorithm.MD5).digestHex(signStr);
    }

PHP签名函数示例：

// 计算签名
    private function getSign($param){
        ksort($param);
        reset($param);
        $signstr = '';
        foreach($param as $k => $v){
            if($k != "sign" && $k != "sign_type" && $v!=''){
                $signstr .= $k.'='.$v.'&';
            }
        }
        $signstr = substr($signstr,0,-1);
        $signstr .= $this->key;
        $sign = md5($signstr);
        return $sign;
    }

payType 传值说明

支付方式的收款号配置在商户后台，分别在我们平台后台的【免签类型】和【签约类型】功能菜单下，调用接口前请确保已经配置了对应的收款账号。
免签类型：收款手机需要安装监控APP挂机。
签约类型：需要开通对应的签约商户和支付产品。
支付方式实际使用体验效果：https://docs.zhifux.com/read/zhifufm/paytype