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,这与它的工作原理有关。
notion image

工作原理

首先,需要在手机上安装GOGO提供的APP,然后APP会监测支付宝和微信的收款消息,这步需要用户在手机上提供权限。
用户在GOGO后台配置服务端信息,如下图,异步回调会在用户支付成功后由GOGO后端发送POST请求到配置的接口上,需要写代码验证,验证成功返回success即可。同步回调会在用户支付成功的同时直接跳转页面到配置的指定链接。
notion image
当用户通过扫码支付正确金额后,会通过监控端APP检测支付宝或微信是否收到相应款数,当确认到收款金额无误GOGO后端会触发回调,回调会发送到用户配置的回调接口上,此时一次支付过程结束。

配置收款码

除了基本的一些系统配置可以自定义调整外,在商户后台必须要配置好收款二维码。至少添加任意金额的微信收款码和支付宝收款码各一张,才能正常使用微信支付和支付宝支付。
  • 支持使用固定金额的收款二维码,无需客户输入金额。
  • 支持多个收款码自动切换轮询,避免收款码失效。
notion image

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:成功,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&param=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)

总结

目前,大多数个人收款解决方案都是使用这类监听端+服务端的方式来运行的,局限性也很大,期待将来能够找到更好的方案。
Python工具——使用Faker制造假数据一个Django版本的开源WebStack导航站点