README
¶
go-union-payment
中文 | English
UnionPayment 是一个整合各种第三方支付网关的工具, 计划支持 Wechat（微信支付）、Alipay（支付宝）、Qpay（QQ钱包）、CMB（招商银行）等等。
之所以存在这个项目，最近公司要做核心服务迁移，目前在经历PHP到GO的重构过程，鉴于之前使用的PHP工具包 [https://github.com/helei112g/payment] 还是比较方便实用，于是借鉴原项目开发者的思想，去重新设计一个属于golang领域的聚合支付工具，方便大家使用。
由于项目属于初期启动阶段，更新较快，测试稳定后会进行release发布
欢迎提PR申请一起参与开发
支付网关 支持列表
- Wechat（微信支付） [开发中]
- Alipay [计划开发]
- Qpay [计划开发]
- China Merchant Bank [计划开发]
- Palpal [计划开发]
微信支付 API
支付宝 API
| API | 完成状态 | 官网文档地址 |
|---|---|---|
| AliApiPayApp | ✅ | app支付接口2.0 https://opendocs.alipay.com/apis/api_1/alipay.trade.app.pay |
| AliApiPayBar | ✅ | （二维码或条码）统一收单交易支付接口 https://opendocs.alipay.com/apis/api_1/alipay.trade.pay |
| AliApiPayQr | ✅ | （二维码）统一收单线下交易预创建 https://opendocs.alipay.com/apis/api_1/alipay.trade.precreate |
| AliApiPayWap | ✅ | 手机网站支付接口2.0 https://opendocs.alipay.com/apis/api_1/alipay.trade.wap.pay |
| AliApiPayWeb | ✅ | PC网站支付 https://opendocs.alipay.com/apis/api_1/alipay.trade.page.pay?scene=API002020081300013629 |
QQ钱包 API
| API | 完成状态 | 官网文档地址 |
|---|---|---|
| QpayApiPayApp | 🕓 | |
| QpayApiPayPub | 🕓 | |
| QpayApiPayQr | 🕓 | |
| QpayApiPayBar | 🕓 |
招商银行 API
@todo
PalPal API
@todo
安装方式
go get github.com/bennya8/go-union-payment
使用说明
第一步
-- 使用任意一种方式加载 支付网关的配置
a) json
configJson, err: = ioutil.ReadFile("./config.json")
if err != nil {
t.Error(err)
}
wechatConfig, err: = wechat.NewConfigWithJson(configJson)
if err != nil {
t.Error(err)
}
b) yaml
configYaml, err: = ioutil.ReadFile("./config.yaml")
if err != nil {
t.Error(err)
}
wechatConfig, err: = wechat.NewConfigWithYaml(configYaml)
if err != nil {
t.Error(err)
}
c) struct
wechatConfig: = wechat.Config {
UseSandbox: false,
UseBackup: false,
AppId: "",
SubAppId: "",
SubMchId: "",
MchId: "",
Md5Key: "",
AppCertPem: "",
AppKeyPem: "",
SignType: "",
LimitPay: nil,
FeeType: "",
ReturnRaw: false,
NotifyUrl: "",
RedirectUrl: "",
}
第二步
-- 调用需要的网关API即可获取返回的结果，简单就完成了
// call the gateway channel api
payData: = map[string] string {
"body": "goods information",
"subject": "debug goods app payment",
"trade_no": "xxx" + strconv.Itoa(rand.Intn(99999999)),
"time_expire": strconv.Itoa(int(time.Now().Unix()) + 600),
"amount": "0.01",
"return_param": "anything_you_want",
"goods_type": "1", // 0 虚拟，1 实物,
"store_id": "",
}
result: = payment.Invoke(payloads.AliApiPayApp, payData)
if !result.State {
t.Error(result.Msg)
}
m, e: = result.Data.ToMap()
fmt.Println(m, e)
j, e: = result.Data.ToJson()
fmt.Println(j, e)
x, e: = result.Data.ToXml()
fmt.Println(x, e)
第三步
-- 设置回调通知
接管回调的服务，需要实现IPaymentNotify接口
type AliPaymentService struct {}
func (a *AliPaymentService) PayNotify(gateway payloads.UnionPaymentGateway, notifyData string) {
if gateway == payloads.AlipayGateway {
// @todo parse notifyData
// and maybe change the order status
}
}
Iris Framework - Route Context
package notify
import (
"fmt"
"github.com/kataras/iris"
"github.com/kataras/iris/mvc"
)
type PaymentController struct {
}
func (c *PaymentController) BeforeActivation(b mvc.BeforeActivation) {
b.HandleMany("POST", "/payment/callback", "Callback")
}
func (c *PaymentController) AfterActivation(a mvc.AfterActivation) {
}
func (c *PaymentController) Callback(ctx iris.Context) mvc.Result {
req := ctx.Request()
service := &AliPaymentService{}
payment := go_union_payment.NewUnionPayment(payloads.AlipayGateway, aliConfig)
payment.ParserNotify(req,service)
}
Build-in net.http Server - http.Request
http.HandleFunc("/your_notify_url", func(w http.ResponseWriter, r *http.Request) {
service := &AliPaymentService{}
payment := go_union_payment.NewUnionPayment(payloads.AlipayGateway, aliConfig)
payment.ParserNotify(r, service)
})
更多例子
单元测试都会同步在以下目录，供参考
/examples/
第三方依赖包
- gopkg.in/yaml.v2
LICENSE
MIT
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type UnionPayment ¶
type UnionPayment struct {
Gateway contracts.IGateway
GatewayIdentify payloads.UnionPaymentGateway
}
func NewUnionPayment ¶
func NewUnionPayment(gateway payloads.UnionPaymentGateway, config contracts.IGatewayConfig) *UnionPayment
func (*UnionPayment) Invoke ¶
func (u *UnionPayment) Invoke(api payloads.UnionPaymentApi, params map[string]string) *payloads.UnionPaymentResult
func (*UnionPayment) ParserNotify ¶
func (u *UnionPayment) ParserNotify(req *http.Request, notify contracts.IPaymentNotify) error
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.