go-wxpay-gateway是封装了与微信支付的相关接口，以更简便易用的形式(封装了各种编码、加解密、证书、 随机数、沙箱的使用)让应用使用微信支付功能go-wxpay-gateway运行后，通过HTTP给需要微信支付的应用提供接口，请求与响应的数据都是JSON，任何支持 HTTP的语言都可以实现业务代码。
- 任何商户平台的配置信息都统一由
go-wxpay-gateway集中管理，应用只要通过应用名、appId就可以使用这些参数 - 任何通知结果的回调信息都统一由
go-wxpay-gateway接收，然后由go-wxpay-notify程序根据应用配置的回调参数进行分发 - 下单、支付、支付结果通知流程
微信支付应用准备好支付信息(订单号、支付金额)，根据应用类型选取相应的支付方式(JSAPI/H5/APP/NATIVE)， 同时把应用名、appId提供给go-wxpay-gatewaygo-wxpay-gateway取出应用名对应的配置信息，附上支付结果通知URL向微信商户平台发出统一支付接口调用微信商户平台返回相应的支付参数go-wxpay-gateway抽取支付相关的参数，生成或包装激活微信支付的参数，返回给微信支付应用微信支付应用把相关参数返回给前端 或者 提供二维码 激活微信app- 用户通过
微信app完成支付 微信商户平台异步把支付结果通知给支付结果通知URL，该URL由go-wxpay-gateway侦听go-wxpay-gateway根据其中的应用名找到配置文件中实际的支付回调URL，生成结果通知日志- 结果通知服务
go-wxpay-notify一直侦听结果通知日志的变化 - 把结果分发给指定的
支付回调URL
-
前提：已经安装go 1.11.x及以上、git、make
-
进入任一文件夹，执行命令
$ git clone https://github.com/rosbit/go-wxpay-gateway $ cd go-wx-gateway $ make -
编译成功，会得到3个可执行程序
go-wxpay-gateway: 微信支付网关程序，可以执行./go-wxpay-gateway -v显示程序信息。go-wxpay-notify: 支付结果通知服务程序，可以执行./go-wxpay-notify -v显示程序信息。go-wxpay-getsandbox: 获取沙箱测试的appKey工具，可以执行./go-wxpay-getsandbox -v显示程序信息。
-
Linux的二进制版本可以直接进入releases下载
- 环境变量
- CONF_FILE: 指明配置的路径，格式见下文
- 配置文件格式
- 是一个JSON
- 可以通过
wxpay-gateway.conf.sample.json进行修改: - 其中的
merchants定义了商户的信息，实际账号和沙箱账号请分别配置 - 其中的
apps定义了应用的信息，项name就是应用名应用名只要可以区分微信支付应用就可以了- 如果使用沙箱测试，另外配置一个带
-dev后缀的应用名，如app-dev，并指向沙箱merchant信息，微信支付应用使用app-dev时不产生实际的费用；等测试成功后，再切换到实际的应用名，如app
- 其中的项
notify-file指的的是通知结果日志文件名 - 其中的项
notify-pay-url、notify-refund-url是外网可以访问的URL，而且需要路由到项endpoints中的notify-pay和notify-refund - 配置项
endpoints中的其它路由确保内网可以使用就可以了
- 运行
$ CONF_FILE=./wxpay-gateway-conf.json ./go-wxpay-gateway
- 环境变量
- CONF_FILE: 指明配置的路径，格式见下文
- 配置文件格式
- 是一个JSON
- 可以通过
wxpay-notify.conf.sample.json进行修改: - 其中的
notify-file是通知结果日志文件名，这个必须和go-wxpay-gateway中的相应配置一致
- 运行
$ CONF_FILE=./wxpay-notify-conf.json ./go-wxpay-notify
- 运行
./go-wxpay-getsandbox <appId> <mchId> <mchAppKey>- 其中<appId>是指公众号、小程序、网页应用等id，请根据应用类型选用正确的appId
- <mchId>是指商户号，申请商户号的时可以拿到
- <mchAppKey>是商户号的appKey，可以进入商户号管理界面设定
- 运行成功后把沙箱mchAppKey输出到屏幕
-
创建订单
- 对应配置项:
create-pay - 访问方法: POST
- URI: 如配置值为
/wxpay/create-pay，则通过/wxpay/create-pay/<type>访问，<type>的可取值为JSAPI、H5、APP、NATIVE - [注意] 由于该接口会使用商户相关的配置信息，该接口不要暴露在外网，只要支付应用可以访问就可以了
- 以下为各种支付方式的参数、响应结果说明:
-
JSAPI支付
-
URI:
/wxpay/create-pay/JSAPI -
请求参数
{ "appId": "公众号或小程序的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "goods": "商品名", "udd": "用户自定义数据", "orderId": "支付应用中唯一的订单号", "fee": 以分为单位的支付额度, "ip": "创建订单的IP地址", "openId": "支付用户在公众号或小程序中的openId" }
-
响应结果
{ "code": 200, "msg": "OK", "result":{ "jsapi_params":{ "appId": "wxc914c55fba939e3c", "nonceStr": "Q6cU6oyVVvSsIWusb20dett1X59h4ezA", "package": "prepay_id=wx20190530150713356368", "paySign": "4F676F3FF2F4719289EA0685928CF83B", "signType": "MD5", "timeStamp": "1559200033" }, "prepay_id": "wx20190530150713356368" } }
-
-
H5支付
-
URI:
/wxpay/create-pay/H5 -
请求参数
{ "appId": "公众号或小程序的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "goods": "商品名", "udd": "用户自定义数据", "orderId": "支付应用中唯一的订单号", "fee": 以分为单位的支付额度, "ip": "创建订单的IP地址", "redirectUrl": "在支付成功后需要跳转的URL", "sceneInfo": { "h5_info": { "type": "类型", "wap_name": "wap应用名", "wap_url": "wap-site-url" } // ---- OR ---- "h5_info": { "type": "类型", "app_name":"ios应用名", "bundle_id": "ios-bundle-id" } // ---- OR ---- "h5_info": { "type": "类型", "app_name":"android应用名", "package_name": "android-package-name" } } } -
响应结果
{ "code": 200, "msg": "OK", "result":{ "pay_url": "weixin://wxpay/s/An4baqw?redirect_url=http%3A%2F%2Flocalhost%3A11083", "prepay_id": "wx20190530150945625582" } }
-
-
APP支付
-
URI:
/wxpay/create-pay/APP -
请求参数
{ "appId": "公众号或小程序的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "goods": "商品名", "udd": "用户自定义数据", "orderId": "支付应用中唯一的订单号", "fee": 以分为单位的支付额度, "ip": "创建订单的IP地址" } -
响应结果
{ "code": 200, "msg": "OK", "result":{ "prepay_id": "wx20190530151116852853", "req_params":{ "appid": "wxc914c55fba939e3c", "noncestr": "iAQIoaqU854JHNnDhG00C0QSbTdIfthD", "package": "Sign=WXPay", "partnerid": "Iamyourpartner", "prepayid": "wx20190530151116852853", "sign": "1ADDF00C546912C446D9B9EA847B0D0F", "timestamp": "1559200276" } } }
-
-
NATIVE支付
-
URI:
/wxpay/create-pay/NATIVE -
请求参数
{ "appId": "公众号或小程序的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "goods": "商品名", "udd": "用户自定义数据", "orderId": "支付应用中唯一的订单号", "fee": 以分为单位的支付额度, "ip": "创建订单的IP地址", "productId": "商品ID" } -
响应结果
{ "code": 200, "msg": "OK", "result":{ "code_url": "weixin://wxpay/s/An4baqw", "prepay_id": "wx20190530151411214102" } }
-
-
- 对应配置项:
-
查询订单
-
对应配置项:
query-order -
访问方法: POST
-
URI: 直接根据配置值访问，如
/wxpay/query-order -
[注意] 该接口配置成一个内网可以访问的API
-
请求参数
{ "appId": "应用的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "orderId": "支付应用中的唯一订单id号" } -
响应结果
{ "app_id": "wxc914c55fba939e3c", "mch_id": "1530730681", "device_info": "sandbox", "result_code": "SUCCESS", "err_code": "SUCCESS", "err_code_des": "SUCCESS", "open_id": "wxd930ea5d5a258f4f", "is_subscribe": true, "trade_type": "JSAPI", "bank_type": "CMC", "total_fee": 101, "settlement_total_fee": 101, "fee_type": "CNY", "cash_fee": 101, "cash_fee_type": "CNY", "coupon_fee": 0, "coupon_count": 0, "coupons": null, "transaction_id": "4662714807620190530105704209783", "order_id": "o002", "attach": "sandbox_attach", "time_end": "20190530105704" }
-
-
关闭订单
-
对应配置项:
close-order -
访问方法: POST
-
URI: 直接根据配置值访问，如
/wxpay/close-order -
[注意] 该接口配置成一个内网可以访问的API
-
请求参数
{ "appId": "应用的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "orderId": "支付应用中的唯一订单id号" } -
响应结果
{ "code": 200, "msg": "OK" }
-
-
创建退款
-
对应配置项:
create-refund -
访问方法: POST
-
URI: 直接根据配置值访问，如
/wxpay/create-refund -
[注意] 该接口配置成一个内网可以访问的API
-
请求参数
{ "appId": "应用的appId", "payApp": "go-wxpay-gateway配置文件中的应用名", "orderId": "支付应用中的唯一订单id号", "refundId": "支付应用中的唯一退款id号", "totalFee": 支付的总费用，单位分, "refundFee": 退款的费用，单位分, "refundReason": "退款理由" } -
响应结果
{ "code": 200, "msg": "OK", "result":{ "app_id": "wxc914c55fba939e3c", "mch_id": "1530730681", "result_code": "", "err_code": "SUCCESS", "err_code_des": "", "transaction_id": "4630338607020190530111333587924", "order_id": "o002", "wx_refund_id": "4630338607020190530111333587", "refund_id": "r002", "total_fee": 101, "settlement_total_fee": 0, "refund_fee": 101, "settlement_refund_fee": 0, "fee_type": "CNY", "cash_fee": 101, "cash_fee_type": "CNY", "cash_refund_fee": 101, "coupon_refund_fee": 0, "coupon_refund_count": 0, "refund_coupons": null } }
-
-
分发通知结果
-
分发支付结果
-
URI: 对应配置文件里
apps列表中的某个notify-pay-callback，可以是一个内网地址 -
方法: POST
-
请求参数:
{ "result_code": "SUCCESS", "err_code": "SUCCESS", "err_code_des": "SUCCESS", "mch_id": "1530730681", "device_info": "APP", "trade_type": "APP", "attach": "any", "bank_type": "CMC", "fee_type": "CNY", "total_fee": 101, "settlement_total_fee": 101, "cash_fee_type": "CNY", "cash_fee": 101, "coupon_count": 0, "coupons": null, "is_subscribe": true, "open_id": "sandboxopenid", "order_id": "o003", "time_end": "20190530151118", "transaction_id": "4391741731420190530151118238943" } -
响应结果:
- 由应用自己决定
-
-
分发退款结果
- URI: 对应配置文件里
apps列表中的某个notify-refund-callback，可以是一个内网地址 - 方法: POST
- 请求参数:
- 参考创建退款
响应结果中的result
- 参考创建退款
- 响应结果:
- 由应用自己决定
- URI: 对应配置文件里
-