简要描述

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

如何对接使用

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

1. 请亲爱的您要耐心看文档,文档为我们精心编写,可以解决您99%遇到的问题,文档有图文对照操作更快捷。
2. 请先看下支付方式效果说明,了解您想用且能用的支付方式的顾客支付效果。
如果您的系统里面有基于“易支付”系接口规范开发的插件,可直接0代码配置对接使用。
易支付插件中使用说明:https://www.bilibili.com/video/BV1F54y1w7FR
加强兼容模式介绍视频:https://www.bilibili.com/video/BV1Vp421y7iF

支付方式传值说明

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

免签类型:收款手机需要安装监控APP挂机。
签约类型:需要开通对应的签约商户和支付产品。
支付方式实际使用体验效果:https://docs.zhifux.com/read/zhifufm/paytype

是否默认 类型 说明
alipay 支付宝,默认是免签类型支付宝收款码。通过用户中心的支付方式关联到具体的收款通道。
wxpay 微信支付,默认对应免签类型微信收款码,通过用户中心的支付方式关联到具体的收款通道。

流程时序图

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

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

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

其他说明

通知IP列表

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

如果你的防火墙不支持掩码形式,直接一个个添加IP。如果掩码形式没有/24这种形式可以增加/8、/16、/24都可以 回调通知出口IP/掩码形式(IP地址范围)列表:

  1. 47.94.194.102/24(47.94.194.102-47.94.194.112)【202439日启用】
  2. 43.143.170.189/24( 43.143.170.189- 43.143.170.199) 2024 4 29日启用】
  3. 39.107.193.170/24 ( 39.107.193.170- 39.107.193.180) 2024 4 30日启用】