Skip to content

WHMCS 财务系统对接金莎云免签支付API(你们怎么用,与我无瓜好吧:)

License

Notifications You must be signed in to change notification settings

tutugreen/WHMCS-JSJ-API-Pay-Gateway

Repository files navigation

WHMCS-JSJ-API-Pay-Gateway

为金莎云(原金沙江)支付免签API写的WHMCS接口。请合理使用。

本接口用于WHMCS与金沙江API接口对接,以完成支付宝/微信/QQ钱包免签支付。

测试可用版本:WHMCS 7.x

理论支持WHMCS 6.x、5.x,未测试。

接口作者与金莎云(原金沙江)无关,不对使用该接口或平台而产生的任何问题负责,请了解。

如果有需要手动补单的,可以在WHMCS系统中使用"添加付款"的功能,请注意填写交易流水号为:JSJApiPay_开头的唯一流水号,以防止重复回调被刷余额。

【PS:这个接口不是帮你挂个监控手动转账订单,而是由金沙江的即时到账接口代收货款,可以申请提现至支付宝或微信。】

快速开始

首先在金沙江API后台 注册/登录账户

下载本接口,并把文件放到站点的/modules/gateways/里。

进入WHMCS后台,系统设置-付款-支付网关-All Payment Gateways选项卡设置中:启用本接口(不同支付方式有独立配置),并在 Manage Existing Gateways 选项卡中填写APIID&APIKEY等,手续费仅用于WHMCS内部记账统计,但是必须填写(可以填0,WHMCS记账有手续费这么个特性,不会对实际支付金额产生影响),涉及货币转换的,请添加CNY货币,并选择转换为CNY。

完成√

说明

代码仅供参考,有问题/BUG等请发Issue(请先确认您的WHMCS版本为6.x/7.x)

使用的API为金沙江API:https://yun.jsjapp.com/

依据金莎云(原金沙江)官方文档写的。未来官方有改动也会更新。

请了解这边订单号是用UID做的,如果您的WHMCS系统订单数量超过99999999个,请联系我帮您修改为其他参数|´・ω・)ノ

PS:如果你需要吧手续费分摊给用户,请参考这个插件:WHMCS-Gateway-Fees (第三方),本插件不会额外添加手续费(建议使用此插件添加,不建议手工修改支付网关文件添加,会产生取整影响回调判断的问题。)

(本来为自用,感觉金莎云(原金沙江)提供的服务还是很不错的,所以公开了,请合理使用)

PPS:微信支付/QQ支付需要审核开通后才能使用无限期维护中。

TODO

清理冗余代码

更新日志

最近版本更新:v0.23(2019-08-11-1)

2019-08-11-1:

修正一些描述Typo。

增加微信独立支付,适配金莎江最新微信接入。

2019-07-02-1:

聚合支付适配临时接口,当前仅支付宝WAP可用。

删除一些Tags。

2018-12-02-01:

支付宝、微信、QQ适配新"远程云发卡接口",比以前更稳了。

增加支付宝移动端独立支付接口。

更新各类失效链接。

删减不必要的代码段。

一些TABの格式化。

2018-10-09-01:

作为历史版本,完善一些细小的偏差。

2018-06-19-01:

修复支付宝Web在部分订单号过小的情况下传值订单格式不正确的问题。

支付宝订单格式:8.apiid."001Invoice".$invoiceid."Ali";

2018-06-02-01:

移除支付宝WAP接口(平台已整合)。

适配新平台,更新说明等。

修改订单格式。

综合格式要求和扩展性,新格式改为如下:

微信:wx23333001Invoice1wx

QQ:qq23333001Invoice1qq

支付宝:ali23333001Invoice1a

其中23333为示例apiid,后接001可修改标识不同站点(当前未放置设定中,如有需要可自行手工修改),末尾做分割符及补足20字符。

取消同步回调,支付完成统一转到账单页等待异步回调。

旧版本更新直接覆盖,并手动删除JSJApiPay_Alipay_Wap.php即可。

2018-01-17-01:

修复多货币情况下,回调转换问题。感谢 @Senrt 的反馈。

优化支付宝WAP支付体验,现直接转到账单页等待异步更新(支付成功会自动刷新)。

增加微信/QQ支付审核提示,可跳转至金莎云(原金沙江)申请审核。

增加金莎云(原金沙江)回调结果支持,在金莎云(原金沙江)面板可显示回调结果。

增加金沙江注册链接(邀请)

调整部分变量为小写,优化代码逻辑,改用定界符输出页面,删除部分多余变量。

优化站点地址获取,去除多余"/"符号。

细节优化。

2017-06-26-01:

修复一些拼写错误。

2017-06-10-01:

Bugs Fix, 修复安全逻辑导致微信/QQ支付回调验证失败的问题。

2017-06-06-01:

改版,不同支付方式可独立设定。

新增微信扫码支付,并极致优化支付体验。

新增QQ钱包支付,支持手机扫码,浏览器唤醒QQ支付等,手机访问可直接启动。

回调地址等依据站点设置自动生成,无需手动修改了。

修正细节错误,简化设定。

逻辑优化,提早判断是否已抵达账单页面,兼容手续费插件,减少账单金额更改几率。

优化金额更改的错误提示(引导联系客服或自助充值)。

更多信息见 https://github.com/tutugreen/WHMCS-JSJ-API-Pay-Gateway/commits/master

请注意!文件名有更改!更新请删除所有旧文件!

此版本已经过N遍测试优化可用,如遇问题优先发Issues。

2017-06-26-01:

修复一些细节拼写错误。

2017-06-04-01:

Bugs Fix,修复callback内的拼写错误导致WAP无法正常回调的问题。

2017-06-04-01:

Bugs Fix,一些修正.

修复回调地址组合缺失系统地址的问题,修正拼写错误,修改名称,修改回调认证失败的目的地(WAP方式回调落地页待完善).

终于码完了微信扫码支付,极致优化支付体验。

2017-06-03-03:

独立出WAP端支付设定,适合纯手机WAP支付。电脑打开也是WAP支付,独立出来后需要至后台支付接口启用WAP支持和设定APIID等信息(可与WEB方式不同,但不建议)。

2017-06-03-02:

为支持多方式支付进行预改版,更改部分文件路径,优化部分代码,请需要更新的用户删除全部旧文件再安装!并需要重新至后台设定接口APIID等信息。

目前如无特殊需求不需要手动修改回调地址了,系统会依据站点地址自动生成。

请注意如果您要申请微信支付等需要绑定回调地址的接口,请确认申请域名填写正确

2017-06-01:

修正一些注释错误

2016-11-18:

修复回调非子目录,导致404的问题

2017-04-17:

更新官方新域名,并支持HTTPS。

请注意!官方已修改接口域名,请在2017-04-17之前下载接口的用户尽快更新代码(对支付和之前的订单无任何影响)

如果在2017年04月17日0点整仍未更改的,接口将无法使用。

官方现已支持 HTTPS 回调地址

2016-11-03:

依据官方要求更新参数编号规范

请注意!官方已修改订单编号(addnum)参数编号规范,请在2016-11-03之前下载接口的用户尽快更新代码(对支付和之前的订单无任何影响)

如果在2016年11月10日0点整仍未更改的,接口将无法使用。(详情见:官方贴 (链接已失效))

常见问题

Q:订单流水号存在"JSJApiPay",是否可以修改?

A:可以的,修改 callback/JSJApiPay_callback.php 相应部分即可(已注释指出),请注意保持唯一性以防刷单。

Q:如何修改用户支付完后跳转到的落地页面。

A:编辑 callback/JSJApiPay_callback.php 相应部分即可(已注释指出),可修改完成支付验证后的地址,默认为跳转到账单页面。

Q:部分支付方式可能需要审核(例如微信支付/QQ支付),如何开通?

A:登陆金莎云(原金沙江)API,账户管理下可以开通相应接口,请注意审核的回调域名填写正确,以免无法正确回调。

Q:为什么有时支付后系统已经到账,但实际账单未支付?

A:请检查订单金额是否和初次提交有更改,例如滞纳金等设定可能影响账单金额导致没有完全支付。

Q:为什么一开始能获取微信支付二维码的,但后来又获取失败了?

A:同上,当账单金额被更改时(例如客户手动使用余额支付部分款项,或者产生了滞纳金),获取会失败,遇到这些情况可以分拆账单,如有顾客有多笔未支付账单,可以使用合并支付生成新账单,或者自助充值,用余额支付剩余款项。

非本接口问题请联系

金莎云(原金沙江)问题请联系其官方客服咨询。

接口问题可联系:窝的Email:yuanming(@)tutugreen.com

Copyright and license

Copyright 2016~2019 Tutugreen.com "o((>ω< ))o". Code released under the MIT license.

About

WHMCS 财务系统对接金莎云免签支付API(你们怎么用,与我无瓜好吧:)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages