Skip to content
为金沙江支付宝免签API写的WHMCS接口。
Branch: master
Clone or download
tutugreen 更新聚合支付接口
适配"远程发卡"。
去除重复参数。
Latest commit 536326f Dec 2, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
JSJApiPay 适配新"远程云发卡"接口 Dec 2, 2018
callback 更新聚合支付接口 Dec 2, 2018
JSJApiPay_Alipay_Wap.php
JSJApiPay_Alipay_Web.php 更新聚合支付接口 Dec 2, 2018
JSJApiPay_Card_Connect.php 更新聚合支付接口 Dec 2, 2018
JSJApiPay_Card_Redeem.php
JSJApiPay_QQ_Pay_QRCode.php
JSJApiPay_WeChat_Pay_QRCode.php 适配新"远程云发卡"接口 Dec 2, 2018
LICENSE
README.md 更新说明 Dec 2, 2018
_config.yml

README.md

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记账有手续费这么个特性,不会对实际支付金额产生影响)。

完成√

说明

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

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

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

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

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

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

PPS:微信支付/QQ支付需要审核开通后才能使用。

TODO

清理冗余代码

更新日志

最近版本更新:v0.21-2018-12-02-01

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.

You can’t perform that action at this time.