GOGO支付——支付宝&微信个人支付系统解决方案

type

Post

status

Published

date

Nov 16, 2022

slug

gogo_pay

summary

对于个人收款支付系统，由于没有营业执照，微信、支付宝官方提供的接口无法使用，个人二维码收款又无法完成支付系统后续工作，这个问题一直以来都没有找到一个适合的解决方案。经过不断尝试，最终找到了一个非常好用的第三方工具来解决这个问题——GOGO支付，提供API接口，支付成功可回调接口。

GOGO支付简介

GOGO支付是一款个人收款服务平台，使用前需要

使用，会给APP_ID和APP_SECRET，默认是体验版，免费使用。后续不需要提供任何个人信息，无需担心任何个人信息泄露问题。缺点就是免费体验版需要自主配置监控端挂机，就是在手机上安装一个APP，这与它的工作原理有关。

工作原理

首先，需要在手机上安装GOGO提供的APP，然后APP会监测支付宝和微信的收款消息，这步需要用户在手机上提供权限。

用户在GOGO后台配置服务端信息，如下图，异步回调会在用户支付成功后由GOGO后端发送POST请求到配置的接口上，需要写代码验证，验证成功返回success即可。同步回调会在用户支付成功的同时直接跳转页面到配置的指定链接。

当用户通过扫码支付正确金额后，会通过监控端APP检测支付宝或微信是否收到相应款数，当确认到收款金额无误GOGO后端会触发回调，回调会发送到用户配置的回调接口上，此时一次支付过程结束。

配置收款码

除了基本的一些系统配置可以自定义调整外，在商户后台必须要配置好收款二维码。至少添加任意金额的微信收款码和支付宝收款码各一张，才能正常使用微信支付和支付宝支付。

支持使用固定金额的收款二维码，无需客户输入金额。

支持多个收款码自动切换轮询，避免收款码失效。

API接入

这里就介绍两个比较重要的API，其余API请查看API文档

创建订单

请求地址：https://www.gogozhifu.com/createOrder

请求方式：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&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)

总结

目前，大多数个人收款解决方案都是使用这类监听端+服务端的方式来运行的，局限性也很大，期待将来能够找到更好的方案。