type
Post
status
Published
date
Nov 16, 2022
slug
gogo_pay
summary
对于个人收款支付系统,由于没有营业执照,微信、支付宝官方提供的接口无法使用,个人二维码收款又无法完成支付系统后续工作,这个问题一直以来都没有找到一个适合的解决方案。经过不断尝试,最终找到了一个非常好用的第三方工具来解决这个问题——GOGO支付,提供API接口,支付成功可回调接口。
tags
工具
category
碎片杂文
icon
password
Property
Nov 16, 2022 10:36 AM
对于个人收款支付系统,由于没有营业执照,微信、支付宝官方提供的接口无法使用,个人二维码收款又无法完成支付系统后续工作,这个问题一直以来都没有找到一个适合的解决方案。经过不断尝试,最终找到了一个非常好用的第三方工具来解决这个问题——GOGO支付,提供API接口,支付成功可回调接口。
GOGO支付简介
GOGO支付是一款个人收款服务平台,使用前需要
使用,会给APP_ID和APP_SECRET,默认是体验版,免费使用。后续不需要提供任何个人信息,无需担心任何个人信息泄露问题。缺点就是免费体验版需要自主配置监控端挂机,就是在手机上安装一个APP,这与它的工作原理有关。
工作原理
首先,需要在手机上安装GOGO提供的APP,然后APP会监测支付宝和微信的收款消息,这步需要用户在手机上提供权限。
用户在GOGO后台配置服务端信息,如下图,异步回调会在用户支付成功后由GOGO后端发送POST请求到配置的接口上,需要写代码验证,验证成功返回success即可。同步回调会在用户支付成功的同时直接跳转页面到配置的指定链接。
当用户通过扫码支付正确金额后,会通过监控端APP检测支付宝或微信是否收到相应款数,当确认到收款金额无误GOGO后端会触发回调,回调会发送到用户配置的回调接口上,此时一次支付过程结束。
配置收款码
除了基本的一些系统配置可以自定义调整外,在商户后台必须要配置好收款二维码。至少添加任意金额的微信收款码和支付宝收款码各一张,才能正常使用微信支付和支付宝支付。
- 支持使用固定金额的收款二维码,无需客户输入金额。
- 支持多个收款码自动切换轮询,避免收款码失效。
API接入
这里就介绍两个比较重要的API,其余API请查看API文档
创建订单
- 请求方式:POST/GET
- 参数说明:
参数 | 参数类型 | 参数说明 |
payId | 字符串 | 【必传】商户订单号,可以是时间戳,不可重复 |
type | 整数 | 【必传】微信支付传入1 支付宝支付传入2 |
price | 字符串 | 【必传】订单金额,保留两位小数的字符串,例如“1.00” |
sign | 字符串 | 【必传】签名,计算方式为将各个参数按顺序拼接后用md5加密, md5(APPID+payId+param+type+price+APPSECRET) |
param | 字符串 | 【可选】传输参数,将会原样返回到异步和同步通知接口 |
isHtml | 整数 | 【可选】传入1则自动跳转到支付页面,否则返回创建结果的json数据 |
notifyUrl | 字符串 | 【可选】传入则设置该订单的异步通知接口为该参数,不传或传空则使用后台设置的接口 |
returnUrl | 字符串 | 【可选】传入则设置该订单的同步跳转接口为该参数,不传或传空则使用后台设置的接口 |
title | 字符串 | 【可选】订单主题、类型,之后可根据该值统计分析数据,最多10个字符 |
content | 字符串 | 【可选】描述订单具体内容、备注等说明文字 |
returnParam | 整数 | 【可选】默认是0,传1即可让官方支付页跳转returnUrl带上回调通知的参数 |
- 返回数据(示例): {"code":1,"msg":"成功","data":{"payId":"1547129707139","orderId":"201901102220147500","payType":2,"price":0.1,"reallyPrice":0.1,"payUrl":"HTTPS://QR.ALIPAY.COM/FKX03500Z2ZYWA0ELYU123","isAuto":1,"state":0,"timeOut":5,"date":1547130014}}
- 返回数据说明:
参数 | 参数类型 | 参数说明 |
code | 整数 | 返回代码(1:成功,0:调用失败) |
msg | 字符串 | api调用结果说明 |
data | 数组 | api调用结果(如果code为0,则data为null) |
- data数据说明
返回参数 | 参数类型 | 参数说明 |
payId | 字符串 | 商户订单号 |
orderId | 字符串 | 云端订单号,可用于查询订单是否支付成功 |
payType | 整数 | 微信支付为1 支付宝支付为2 |
price | 字符串 | 订单金额,保留两位小数的字符串,例如1.00 |
reallyPrice | 字符串 | 实际需付金额,保留两位小数的字符串,例如1.00 |
payUrl | 字符串 | 支付二维码内容 |
isAuto | 整数 | 1需要手动输入金额 0扫码后自动输入金额 |
state | 整数 | 订单状态:-1 订单过期 0 等待支付 1 完成 2 支付完成但通知失败 |
timeOut | 整数 | 订单有效时间(分钟) |
date | 长整数 | 订单创建时间时间戳(10位) |
Python请求示例:
def getOrderInfo(pay_id, p_type, price, content, notifyUrl=None, returnUrl=None): param = 'Quanfita' print(str(APP_ID+pay_id+p_type+price+APP_SECRET)) data = { "payId": pay_id, "type": p_type, "price": price, "param": param, 'isHtml' : 1, 'sign': hashlib.md5(str(APP_ID+pay_id+param+p_type+price+APP_SECRET).encode(encoding='UTF-8')).hexdigest(), 'content': content } if notifyUrl is not None: data['notifyUrl'] = notifyUrl if returnUrl is not None: data['returnUrl'] = returnUrl headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.69 Safari/537.36 Edg/95.0.1020.44", "content-type": "application/json", "charset": "utf-8", "App-Id": APP_ID, "App-Secret": APP_SECRET } response = requests.post(BASE_URL,json=data,headers=headers) res = response.text print(data) print(res) # 存储数据 return res
回调通知
- 传输参数(示例):payId=1547130349673¶m=gump994&type=2&price=0.10&reallyPrice=0.10&sign=28943820b95019b6a63598a13c46f93f
- 参数获取:同时支持GET和POST方式获取回调的参数
- 传输参数说明:
返回参数 | 参数类型 | 参数说明 |
payId | 字符串 | 商户订单号 |
param | 字符串 | 创建订单的时候传入的参数 |
type | 整数 | 支付方式 :微信支付为1 支付宝支付为2 |
price | 字符串 | 订单金额,保留两位小数的字符串,例如1.00 |
reallyPrice | 字符串 | 实际支付金额,保留两位小数的字符串,例如1.00 |
sign | 字符串 | 校验签名,计算方式为对各个参数按顺序拼接后的字符串用md5加密, md5(APPID + payId + param + type + price + reallyPrice + APPSECRET) |
Python回调示例:
def checkCallback(pay_id, param, p_type, price, reallyPrice, sign): if hashlib.md5(str(APP_ID+pay_id+param+p_type+price+reallyPrice+APP_SECRET).encode(encoding='UTF-8')).hexdigest() == sign: return True else: return False def CallbackView(request): if request.method == 'POST': pay_id = request.GET.get('payId') param = request.GET.get('param') p_type = request.GET.get('type') price = request.GET.get('price') reallyPrice = request.GET.get('reallyPrice') sign = request.GET.get('sign') if checkCallback(pay_id, param, p_type, price, reallyPrice, sign): return HttpResponse("success") else: HttpResponse("Failed", 403) return HttpResponse("Failed", 403)
总结
目前,大多数个人收款解决方案都是使用这类监听端+服务端的方式来运行的,局限性也很大,期待将来能够找到更好的方案。
- Author:Quanfita
- URL:https://quanfita.cn/article/gogo_pay
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
Relate Posts