本平台接口兼容易支付接口规范，但是易支付的支付方式不同平台定义不同，我们兼容易支付的接口参数规范如下，其中需要特别注意 支付方式传值按照本平台规范传入值。
如果您的网站后台已经预置了易支付的接口设置项，可以将对应的参数配置进去，然后检查或者修改代码中的支付方式传值与本平台定义的一致就可以了。
本文主要展示兼容的易支付参数列表，并不过多介绍如何对接易支付系规范，如果您的系统后台没有易支付的配置项，请根据我们平台规范对接。易支付规范默认只有支付宝、微信的支付方式，对应我们平台的免签支付宝和微信的收款码支付方式。

如何在易支付插件中使用说明：https://www.bilibili.com/video/BV1F54y1w7FR
兼容模式加强介绍视频：https://www.bilibili.com/video/BV1Vp421y7iF

接口主要参数值对应关系如下，以下参数值均在支付FM商户后台【用户中心】处查看
接口URL地址 ➡️ 兼容易接口地址
商户ID ➡️ 商户号
商户密钥KEY➡️接入密钥
易支付API - 图1

对接前置工作

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

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

页面跳转支付

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

URL地址：【兼容易支付规范接口地址】

【兼容易支付规范接口地址】:在支付FM商户后台【用户中心】处可查看，一般有些系统的接口地址配置时候不用带/，如果请求失败，请去掉 兼容易支付规范接口地址后的 / 或 容易支付规范接口地址后拼接 submit.php
示例：【兼容易支付规范接口地址】为http://api-1tecywsv9xc0.zhifu.fm.it88168.com/api/, 填入插件报错，去掉尾部的/修改为http://api-1tecywsv9xc0.zhifu.fm.it88168.com/api/ 再试下，仍旧报错 再修改为http://api-1tecywsv9xc0.zhifu.fm.it88168.com/api/submit.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

页面跳转模式请求参数说明

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

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

字段名 变量名 必填 类型 示例值 描述
商户ID pid 是 String 1001 对应支付FM平台的商户号。在支付FM商户后台【用户中心】处可查看,该值不是用户名。
支付方式 type 是 String alipay,wxpay 易支付规范默认只有支付宝、微信的支付方式。其他支付方式传值按照本平台规范修改传入值即可使用。点击查看支付方式列表
商户订单号 out_trade_no 是 String 20160806151343349 商户订单号。仅允许字母或纯数字，建议不超过32字符，不能有中文
异步通知地址 notify_url 是 String 域名/notify_url.php 服务器异步通知地址
跳转通知地址 return_url 是 String 域名/return_url.php 支付成功（订单支付状态为已支付）后页面跳转地址
商品名称 name 是 String VIP会员
商品金额 money 是 number 1.00 订单金额。请求的支付金额（单位：元），最多小数点后保留2位
网站名称 sitename 否 String 云任务
业务扩展参数 param 否 String 没有请留空 支付后原样返回
签名字符串 sign 是 String 202cb962ac59075b964b07152d234b70 签名算法点此查看签名算法中的KEY 对应支付FM平台的“接入密钥”，在支付FM商户后台【用户中心】处可查看
签名类型 sign_type 是 String MD5 默认为MD5

API接口支付方式

此接口可用于服务器后端发起支付请求，会返回支付二维码链接或支付跳转url。

URL地址：在支付FM商户后台【用户中心】处可查看到的“兼容易支付规范接口地址”，一般有些系统的接口地址配置时候不用带/，如果请求失败，请去掉“兼容易支付规范接口地址”后的 / 或 “兼容易支付规范接口地址”后拼接 mapi.php

请求方式：POST

请求参数说明：

字段名 变量名 必填 类型 示例值 描述
商户ID pid 是 Int 1001
支付方式 type 是 String alipay 支付方式列表
商户订单号 out_trade_no 是 String 20160806151343349
异步通知地址 notify_url 是 String http://域名/notify_url.php 服务器异步通知地址
跳转通知地址 return_url 否 String http://域名/return_url.php 页面跳转通知地址
商品名称 name 是 String VIP会员 如超过127个字节会自动截取
商品金额 money 是 String 1.00 单位：元，最大2位小数
用户IP地址 clientip 是 String 192.168.1.100 用户发起支付的IP地址
设备类型 device 否 String pc 根据用户浏览器的UA判断，传入用户所使用的浏览器或设备类型，默认为pc设备类型列表
业务扩展参数 param 否 String 没有请留空 支付后原样返回
签名字符串 sign 是 String 202cb962ac59075b964b07152d234b70 签名算法点此查看
签名类型 sign_type 是 String MD5 默认为MD5

返回结果（json）：

字段名 变量名 类型 示例值 描述
返回状态码 code Int 1 1为成功，其它值为失败
返回信息 msg String 失败时返回原因
订单号 trade_no String 20160806151343349 支付订单号
支付跳转url payurl String https://page-admuk8xjk8ow.zhifu.fm.it88168.com/apiPay?orderNo=363823183490842624 如果返回该字段，则直接跳转到该url支付
二维码链接 qrcode String https://page-admuk8xjk8ow.zhifu.fm.it88168.com/apiPay?orderNo=363823183490842624 如果返回该字段，则根据该url生成二维码

支付结果通知

通知类型：服务器异步通知（notify_url）

请求方式：GET

请求参数说明：

字段名 变量名 必填 类型 示例值 描述
商户ID pid 是 String 1001 对应支付FM平台的商户号。在支付FM商户后台【用户中心】处可查看,该值不是用户名。
支付订单号 trade_no 是 String 20160806151343349021 聚合支付订单号
商户订单号 out_trade_no 是 String 20160806151343349 商户系统内部的订单号
支付方式 type 是 String alipay,wxpay 支付方式列表
商品名称 name 是 String VIP会员
商品金额 money 是 String 1.02
支付状态 trade_status 是 String TRADE_SUCCESS
签名字符串 sign 是 String 202cb962ac59075b964b07152d234b70 签名算法见下文
签名类型 sign_type 是 String MD5 默认为MD5

MD5签名算法

KEY 对应支付FM用户中心的 接入密钥
请对参数按照键名进行降序排序（a-z），sign sign_type 和空值不进行签名！。 排序后请操作参数生成或拼接一个url请求字符串 例如 a=b&c=d&e=f (Url值不能携带参数！不要进行urlencode) 再将拼接好的请求字符串与平台生成的Key进行MD5加密得出sign签名参数 md5 ( a=b&c=d&e=f + KEY ) (注意：+ 为各语言的拼接符！不是字符！)，md5为小写