简要描述
本文主要面向有一定开发基础的用户查阅对接,请仔细阅读接口文档,可以下载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接口清单
点击下方文字链接查看接口的详细说明。
支付方式传值说明
支付方式的收款号配置在商户后台,分别在我们平台后台的【免签类型】和【签约类型】功能菜单下,调用接口前请确保已经配置了对应的收款账号。
值 | 是否默认 | 类型 | 说明 | 收款号类型 | 分派方式 | 适用端口 |
---|---|---|---|---|---|---|
否 | string | 收款码 - 微信 | 免签 | 收款号随机或轮训 | PC&WAP | |
alipay | 否 | string | 收款码 - 支付宝(上传模式和动态码模式) | 免签 | 收款号随机或轮训 | PC&WAP |
unipay | 否 | string | 收款码 - 云闪付 | 免签 | 收款号随机或轮训 | PC&WAP |
qujie.qrcode | 否 | string | 收款码 - 微商相册或趣街小二 | 免签 | 收款号随机或轮训 | PC&WAP |
jsnx.qrcode | 否 | string | 收款码 - 农商行收银宝 | 免签 | 收款号随机或轮训 | PC&WAP |
bankapp | 否 | string | 网银APP收款 | 免签 | 收款号随机或轮训 | PC&WAP |
sqb.qrcode | 否 | string | 收钱吧APP收款码 | 免签 | 收款号随机或轮训 | PC&WAP |
fubei.qrcode | 否 | string | 付呗APP收款码 | 免签 | 收款号随机或轮训 | PC&WAP |
qdl.qrcode | 否 | string | 钱到啦APP收款码 | 免签 | 收款号随机或轮训 | PC&WAP |
alipaysign | 否 | string | 支付宝网站支付接口(电脑或手机自适应) | 直连支付宝官方签约 |
商户号轮训 | PC&WAP |
alipay.direct.pc | 否 | string | 支付宝电脑网站支付 | 直连支付宝官方签约 |
商户号轮训 | PC |
alipay.direct.wap | 否 | string | 支付宝手机网站支付 | 直连支付宝官方签约 |
商户号轮训 | WAP |
alipay-facetoface | 否 | string | 支付宝当面付,跨地区收款不推荐使用 | 直连支付宝官方签约 |
商户号轮训 | PC&WAP |
wxpayh5 | 否 | string | 微信支付H5 | 直连微信官方签约 |
商户号轮训 | WAP |
wxpaynative | 否 | string | 微信支付Native | 直连微信官方签约 |
商户号轮训 | PC |
wxpayjsapi | 否 | string | 微信支付JSAPI | 直连微信官方签约 |
商户号轮训 | PC&WAP |
fuyou-aliqr | 否 | string | 富友支付宝服务窗 | 富友间连支付宝签约 |
商户号轮训 | PC&WAP |
fuyou-wxqr | 否 | string | 富友微信支付 | 富友间连微信签约 |
商户号轮训 | PC&WAP |
fuyou-bankqr | 否 | string | 富友支付-网银APP扫码 | 富友间连银联签约 |
商户号轮训 | PC&WAP |
fuyou-pcqr | 否 | string | 富友收银台 | 富友间连签约 |
商户号轮训 | PC&WAP |
sandpayh5 | 否 | string | 杉德支付收银台 | 杉德间连签约支付宝微信 |
商户号轮训 | PC&WAP |
alipay-pc-all | 否 | string | 支付宝PC签约轮训,见说明 | 直连+间连支付宝签约 |
签约通道轮训+商户号轮训 |
PC |
alipay-wap-all | 否 | string | 支付宝WAP签约轮训,见说明 | 直连+间连支付宝签约 |
签约通道轮训+商户号轮训 |
WAP |
wechat-pc-all | 否 | string | 微信PC签约轮训,见说明 | 直连+间连微信签约 |
签约通道轮训+商户号轮训 |
PC |
wechat-wap-all | 否 | string | 微信WAP签约轮训,见说明 | 直连+间连微信签约 |
签约通道轮训+商户号轮训 |
WAP |
表中特殊值说明:
alipay-pc-all
包含:alipaysign,alipay.direct.pc,alipay-facetoface, fuyou-aliqr,sandpayh5alipay-wap-all
包含:alipaysign,alipay.direct.wap,alipay-facetoface, fuyou-aliqr,sandpayh5wechat-pc-all
包含:wxpaynative,wxpayjsapi,fuyou-wxqr,sandpayh5wechat-wap-all
包含:wxpayh5,wxpayjsapi,fuyou-wxqr,sandpayh5
主要用于签约类型的跨通道商户号的合理轮训分派收单使用。例如:传入 alipay-pc-all调用接口时候,将轮训分派所有可以在电脑网站使用的商户号进行收单。
相关下载
- 接口请求demo下载
- 插件下载
以下系统的直接安装插件,不需要进行API接口对接,插件开源可以自行二开。
流程时序图
简单的场景流程例子: 客户在您业务系统买东西,点击付款弹出支付FM支付链接,客户完成付款。支付FM系统收到您的收款账号所属的支付平台支付成功反馈,支付FM将支付结果通知到您的业务系统。
图中相关名词解释
业务系统:您用来实现您的具体业务的系统。
第三方支付平台:您的收款号所属平台,包括但不限于支付宝、微信、网银等等
支付FM:本平台开放接口
通知IP列表
请需要设置IP地址请求访问白名单的用户注意设置防火墙等安全工具中的IP地址段,之前未有设置过IP段的用户不需做调整。
回调通知出口IP段(IP/掩码形式)列表:
110.42.6.171/27(即110.42.6.171到110.42.6.191)
39.107.246.200/27(即39.107.246.200到39.107.246.223)
如果你的防火墙不支持掩码形式,直接一个个添加IP。如果掩码形式没有/27这种形式可以增加/8、/16、/24都可以