简单三步 快速接入
使用邮箱验证码即可快速注册,无需付费,默认开通体验通道快速上手~ 立即注册
除了基本的一些系统配置可以自定义调整外,在商户后台必须要配置好收款通道。体验通道至少添加任意金额的微信收款码和支付宝收款码各一张,才能正常使用微信支付和支付宝支付。
√ 支持多通道到自动轮询,处理高并发。
√ 支持使用固定金额的收款二维码,无需客户输入金额。
√ 支持多个收款码自动切换轮询,避免收款码失效。
我们提供专业的技术服务协助API接入,您也可以参考开发文档自行接入。主要的步骤是在您的项目里调用创建订单的API,以及配置好相对应的回调方法。
√ 详细的API接入文档。
√ 提供兼容其他支付模块的兼容接口。
√ 提供丰富的DEMO和插件作为参考。
图文版
视频版
参考下方接口文档进行开发接入,只需重点关注 “创建订单”接口和“回调通知说明” 即可,其他都是可选备用接口。
在接入过程中有任何问题欢迎联系我们,我们会为您提供专业的接入技术服务~
注意事项:
数据编码统一为utf-8,Request和Response数据格式为application/json
所有接口必须设置请求头:"App-Id: 你的APPID"。例如:"App-Id: ec241e3b9df4f447dc03754e80461234"
所有接口必须设置请求头:“App-Secret: 你的AppSecret”。 例如:"App-Secret: fa36d1f43d1a95e21c84625b3cb48888"
所有接口必须设置请求头:“App-Sign: md5(APPID + AppSecret)”。 直接明文传递Secret可能存在风险,因此改传App-Sign,格式是APPID和AppSecret拼接后用md5进行加密
APPID和AppSecret注册成功后可在商户后台“系统设置”中获取。
请求地址:https://www.gogozhifu.com/createOrder
请求方式:POST/GET
参数说明:
参数 参数类型 参数说明 payId 字符串 【必传】商户订单号,可以是时间戳,不可重复 type 整数 【必传】微信支付传入1 支付宝支付传入2 price 字符串 【必传】订单金额,保留两位小数的字符串,例如“1.00” param 字符串 【必传】传输参数,可传空字符串,会原样返回到异步和同步通知接口 sign 字符串 【必传】签名,计算方式为将各个参数按顺序拼接后用md5加密, md5(APPID+payId+param+type+price+APPSECRET) isHtml 整数 【可选】传入1则自动跳转到支付页面,否则返回创建结果的json数据 notifyUrl 字符串 【可选】传入则设置该订单的异步通知接口为该参数,不传或传空则使用后台设置的接口 returnUrl 字符串 【可选】传入则设置该订单的同步跳转接口为该参数,不传或传空则使用后台设置的接口 wayId 整数 【可选】通道Id,您可以指定自己拥有的某个通道进行收款,通道id在后台“收款通道”列表中获取。 wayTypeId 整数 【可选】通道类型Id,您可以指定某个通道类型进行收款,通道类型id在后台“收款通道”列表中获取。 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)
返回参数 参数类型 参数说明 payId 字符串 商户订单号 orderId 字符串 云端订单号,可用于查询订单是否支付成功 payType 整数 微信支付为1 支付宝支付为2 price 字符串 订单金额,保留两位小数的字符串,例如1.00 reallyPrice 字符串 实际需付金额,保留两位小数的字符串,例如1.00 payUrl 字符串 支付二维码内容 isAuto 整数 1需要手动输入金额 0扫码后自动输入金额 state 整数 订单状态:-1|订单过期 0|等待支付 1|完成 2|支付完成但通知失败 timeOut 整数 订单有效时间(分钟) date 长整数 订单创建时间时间戳(10位)
当系统收到用户收款后,将会向您的异步通知地址发送POST请求,通知您的服务端订单完成收款当您正常处理完自己的业务流程后,请返回一个字符串"success",这样GOGO支付才会判定为通知成功,完成订单。
传输参数(示例):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)
<?php ini_set("error_reporting","E_ALL & ~E_NOTICE"); $appId = "ec241e3b9df4f447dc03754e8046888b"; //APPID $appSecret = "fa36d1f43d1a95e21c84625b3cb41234"; //APPSECRET $payId = $_GET['payId'];//商户订单号 $param = $_GET['param'];//创建订单的时候传入的参数 $type = $_GET['type'];//支付方式 :微信支付为1 支付宝支付为2 $price = $_GET['price'];//订单金额 $reallyPrice = $_GET['reallyPrice'];//实际支付金额 $sign = $_GET['sign'];//校验签名,计算方式 = md5(appId + payId + param + type + price + reallyPrice + appSecret) //开始校验签名 $_sign = md5($appId . $payId . $param . $type . $price . $reallyPrice . $appSecret); if ($_sign != $sign) { echo "error_sign";//sign校验不通过 exit(); } echo "success"; //继续业务流程 //echo "商户订单号:".$payId ."<br>自定义参数:". $param ."<br>支付方式:". $type ."<br>订单金额:". $price ."<br>实际支付金额:". $reallyPrice; ?>
请求地址:https://www.gogozhifu.com/getOrder
请求方式:POST/GET
参数示例(示例):orderId=201901102225513177
参数说明:
参数 参数类型 参数说明 orderId 字符串 【必传】云端订单号,创建订单返回的
返回数据(示例):{"code":1,"msg":"成功","data":{"payId":"1547129707139","orderId":"201901102220147500","payType":2,"price":0.10,"reallyPrice":0.10,"payUrl":"HTTPS://QR.ALIPAY.COM/FKX03500Z2ZYWA0ELYUB5D","isAuto":1,"state":0,"timeOut":5,"date":1547130014}}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:成功,0:调用失败) msg 字符串 api调用结果说明 data 数组 api调用结果(如果code为0,则data为null)
返回参数 参数类型 参数说明 payId 字符串 商户订单号 orderId 字符串 云端订单号,可用于查询订单是否支付成功 payType 整数 微信支付为1, 支付宝支付为2 price 字符串 订单金额,保留两位小数的字符串,例如1.00 reallyPrice 字符串 实际需付金额,保留两位小数的字符串,例如1.00 payUrl 字符串 支付二维码内容 isAuto 整数 1需要手动输入金额 0扫码后自动输入金额 state 整数 订单状态:-1订单过期, 0等待支付, 1完成, 2支付完成但通知失败 timeOut 整数 订单有效时间(分钟) date 长整数 订单创建时间时间戳(10位)
https://www.gogozhifu.com/checkOrder
请求方式:POST/GET
参数示例(示例):orderId=201901102225513177
参数说明:
参数 参数类型 参数说明 orderId 字符串 【必传】云端订单号,创建订单返回的
返回数据(示例):{"code":1,"msg":"成功","data":"https://bbs.125.la/?payId=1547130880571¶m=gump994&type=2&price=0.10&reallyPrice=0.10&sign=c79f041bd5bc47d73bc19dc8406c9843"}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:订单已被支付,0:支付失败或还未支付,具体查看msg字段) msg 字符串 调用结果说明 data 字符串 如果code为0,则data为null,否则为该订单支付完成后的跳转地址(带回调参数)
请求地址:https://www.gogozhifu.com/closeOrder
请求方式:POST/GET
参数示例(示例):orderId=201901102225513177&payId=ABC123456
参数说明:(两个参数至少需要传其中一个)
参数 参数类型 参数说明 orderId 字符串 【可选】云端订单号,创建订单返回的 payId 字符串 【可选】商户订单号,商户自定义唯一单号
返回数据(示例):{"code":1,"msg":"成功","data":null}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:订单关闭成功,0:订单关闭失败,具体原因查看msg字段) msg 字符串 调用结果说明 data 字符串 无用字段,请忽略
请求地址:https://www.gogozhifu.com/deleteOrder
请求方式:POST/GET
参数示例(示例):orderId=201901102225513177&payId=ABC123456
参数说明:(两个参数至少需要传其中一个)
参数 参数类型 参数说明 orderId 字符串 【可选】云端订单号,创建订单返回的 payId 字符串 【可选】商户订单号,商户自定义唯一单号
返回数据(示例):{"code":1,"msg":"成功","data":null}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:订单删除成功,0:订单删除失败,具体原因查看msg字段) msg 字符串 调用结果说明 data 字符串 无用字段,请忽略
请求地址:https://www.gogozhifu.com/getState
请求方式:POST/GET
参数说明: 无
返回数据(示例):{"code":1,"msg":"成功","data":{"lastpay":"1547394640","lastheart":"1547613873","state":"1"}}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:成功,0:失败,具体原因查看msg字段) msg 字符串 调用结果说明 data 字符串 api调用结果(如果code为0,则data为null)
返回参数 参数类型 参数说明 lastpay 长整数 最后一次监控到支付的时间戳(10位) lastheart 长整数 最后一次监控端向服务器发送心跳的时间戳(10位) state 整数 监控端状态, 1在线, 0掉线, -1还未绑定监控端
请求地址:https://www.gogozhifu.com/checkZfbNo
请求方式:POST/GET
参数示例(示例):no=20210928200040011100130041978888&amount=2.33
参数说明:
参数 参数类型 参数说明 no 字符串 【必须】支付宝交易订单号,在支付宝账单详情中可以看到一串很长的订单号 amount 字符串 【可选】交易金额,如果传了该值则还会比较金额是否满足;不传只查询是否存在订单号
返回数据(示例):{"code":1,"msg":"ok","data":""}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:说明订单号存在,代表交易成功。0:失败) msg 字符串 调用结果说明 data 字符串
请求地址:https://www.gogozhifu.com/zfbBd
请求方式:POST/GET
参数示例(示例):zfbNo=20210928200040011100130041978888&payId=1688812345
参数说明:
参数 参数类型 参数说明 zfbNo 字符串 【必须】支付宝交易订单号,在支付宝账单详情中“更多”,可以看到一串很长的订单号 payId 字符串 【必须】商户自定义的单号
返回数据(示例):{"code":1,"msg":"补单成功","data":""}
返回数据说明:
返回参数 参数类型 参数说明 code 整数 返回代码(1:说明补单成功。0:失败) msg 字符串 提示信息 data 字符串
如果您的系统里带有一些其他已经配置的支付模块或支付接口,例如“易支付”、“码支付”等,可以直接配置我们兼容接口。
参照下方对应说明,配置相应接口地址及参数,无需开发,快速接入!
请求地址:https://www.gogozhifu.com/index.php/yzf/submit.php
请求方式:POST/GET
请求参数: (与通用的易支付一致,不展开说明)
返回数据: (与通用的易支付一致,不展开说明)
配置方式:
1.配置易支付接口地址:https://www.gogozhifu.com/index.php/yzf/submit.php
(如果你的系统后台的接口地址配置是不带“submit.php”的,那就只配置https://www.gogozhifu.com/index.php/yzf/即可)
2.配置pid相当于是GOGO支付商户的APP_ID
3.配置key相当于是GOGO支付商户的APP_Secret
请求地址:https://www.gogozhifu.com/mzf
请求方式:POST/GET
请求参数: (与码支付模式一致,不展开说明)
返回数据: (与码支付模式一致,不展开说明)
配置方式:
1.配置码支付接口地址:https://www.gogozhifu.com/mzf
(一般码支付接口地址是xxx.xxx/create_order/?xxx=xxx,把这些改成https://www.gogozhifu.com/mzf?xxx=xxx即可)
2.配置商户编号相当于是GOGO支付商户的APP_ID
3.配置商户密钥相当于是GOGO支付商户的APP_Secret
如果您用的是其他支付模块、支付接口,请联系我们客服添加兼容接口~