简要描述

本文主要面向有一定开发基础的用户查阅对接,请仔细阅读接口文档,可以下载DEMO参考对接代码样例。 接口支持免签类型、签约接口类型的支付方式。 免签和签约接口相同,不同处为创建支付订单参数“支付方式 payType”的传值。
接口测试工具:Postmam 或 在线工具http://coolaf.com/

如何对接使用

一句话概括:想用什么支付方式,您需要有对应的收款账号,然后配置到支付FM后台对应位置,最后技术对接我们接口。

1. 请亲爱的您要耐心看文档,文档为我们精心编写,可以解决您99%遇到的问题,文档有图文对照操作更快捷。
2. 请先看下支付方式效果说明,了解您想用且能用的支付方式的顾客支付效果。
3. 根据对接步骤完成相应的支付方式的配置,然后安排技术对接API即可。
有调用示例、demo以及插件提供参考,接口调用很简单,能看懂API说明的入门级开发者就可以接入。如果需要系统插件请联系我们客服我们会根据需求量开发并开源发布。
如果您的系统里面有基于“易支付”系接口规范开发的插件,可直接参考易支付兼容说明,便可快速对接使用。
兼容API - 易支付API https://docs.zhifux.com/read/zhifufm/api-epay

API接口清单

点击下方文字链接查看接口的详细说明。

支付方式传值说明

支付方式的收款号配置在商户后台,分别在我们平台后台的【免签类型】和【签约类型】功能菜单下,调用接口前请确保已经配置了对应的收款账号。

是否默认 类型 说明 类型类型
wechat string 收款码 - 微信 免签
alipay string 收款码 - 支付宝(上传模式和动态码模式) 免签
unipay string 收款码 - 云闪付 免签
qujie.qrcode string 收款码 - 趣街小二商家版 免签
jsnx.qrcode string 收款码 - 农商行收银宝 免签
bankapp string 网银APP收款 免签
sqb.qrcode string 收钱吧APP收款码 免签
fubei.qrcode string 付呗APP收款码 免签
qdl.qrcode string 钱到啦APP收款码 免签
alipaysign string 支付宝网站支付接口(电脑或手机自适应) 签约
alipay.direct.pc string 支付宝电脑网站支付 签约
alipay.direct.wap string 支付宝手机网站支付 签约
alipay-facetoface string 支付宝当面付 签约
wxpayh5 string 微信支付H5 签约
wxpaynative string 微信支付Native 签约
wxpayjsapi string 微信支付JSAPI 签约
fuyou-aliqr string 富友支付-支付宝服务窗扫码 签约
fuyou-wxqr string 富友支付-微信扫码 签约
fuyou-bankqr string 富友支付-网银APP扫码 签约
fuyou-pcqr string 富友收银台 签约富友
sandpayh5 string 杉德支付收银台 签约杉德

相关下载

流程时序图

简单的场景流程例子: 客户在您业务系统买东西,点击付款弹出支付FM支付链接,客户完成付款。支付FM系统收到您的收款账号所属的支付平台支付成功反馈,支付FM将支付结果通知到您的业务系统。

Created with Raphaël 2.1.2顾客顾客业务系统业务系统支付FM支付FM第三方支付平台第三方支付平台支付订单创建订单API分派您配置好的收款号接单返回支付链接支付链接您的收款号所属平台进行支付支付完成支付平台提示已支付提醒收款号收款到账支付成功通知订单状态更新“已支付”支付页面提示支付成功异步回调通知API返回“success”更新顾客订单数据等

图中相关名词解释
业务系统:您用来实现您的具体业务的系统。
第三方支付平台:您的收款号所属平台,包括但不限于支付宝、微信、网银等等
支付FM:本平台开放接口

通知IP列表

请需要设置IP地址请求访问白名单的用户注意设置防火墙等安全工具中的IP地址段,之前未有设置过IP段的用户不需做调整。

回调通知出口IP段(IP/掩码形式)列表:

  1. 110.42.6.171/27(即110.42.6.171110.42.6.191
  2. 39.107.246.200/27(即39.107.246.20039.107.246.223
  3. 如果你的防火墙不支持掩码形式,直接一个个添加IP。如果掩码形式没有/27这种形式可以增加/8、/16、/24都可以