91 lines
3.0 KiB
Markdown
91 lines
3.0 KiB
Markdown
|
[](https://packagist.org/packages/alipaysdk/easysdk)
|
|||
|
|
[](https://app.fossa.com/projects/git%2Bgithub.com%2Falipay%2Falipay-easysdk?ref=badge_shield)
|
|||
|
|
|
|||
|
|
欢迎使用 Alipay **Easy** SDK for Go 。
|
|||
|
|
|
|||
|
|
Alipay Esay SDK for Go让您不用复杂编程即可访支付宝开放平台开放的各项常用能力，SDK可以自动帮您满足能力调用过程中所需的证书校验、加签、验签、发送HTTP请求等非功能性要求。
|
|||
|
|
|
|||
|
|
下面向您介绍Alipay Easy SDK for Go 的基本设计理念和使用方法。
|
|||
|
|
|
|||
|
|
## 设计理念
|
|||
|
|
|
|||
|
|
Alipay Easy SDK主要目标是提升开发者在**服务端**集成支付宝开放平台开放的各类核心能力的效率。
|
|||
|
|
|
|||
|
|
## 环境要求
|
|||
|
|
1. Alipay Easy SDK for Go 需要配合`Go 1.12`或其以上版本。
|
|||
|
|
|
|||
|
|
2. 使用 Alipay Easy SDK for Go 之前 ，您需要先前往[支付宝开发平台-开发者中心](https://openhome.alipay.com/platform/developerIndex.htm)完成开发者接入的一些准备工作，包括创建应用、为应用添加功能包、设置应用的接口加签方式等。
|
|||
|
|
|
|||
|
|
3. 准备工作完成后，注意保存如下信息，后续将作为使用SDK的输入。
|
|||
|
|
|
|||
|
|
* 加签模式为公钥证书模式时（推荐）
|
|||
|
|
|
|||
|
|
`AppId`、`应用的私钥`、`应用公钥证书文件`、`支付宝公钥证书文件`、`支付宝根证书文件`
|
|||
|
|
|
|||
|
|
* 加签模式为公钥模式时
|
|||
|
|
|
|||
|
|
`AppId`、`应用的私钥`、`支付宝公钥`
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
手动下载go目录下源码集成即可
|
|||
|
|
|
|||
|
|
## 快速使用
|
|||
|
|
以下这段代码示例向您展示了使用Alipay Easy SDK for Go调用一个API的3个主要步骤：
|
|||
|
|
|
|||
|
|
1. 设置参数（全局只需设置一次）。
|
|||
|
|
2. 发起API调用。
|
|||
|
|
3. 处理响应或异常。
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
package main
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"encoding/json"
|
|||
|
|
"fmt"
|
|||
|
|
"kernel"
|
|||
|
|
"time"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
func init() {
|
|||
|
|
account:= kernel.Client{}
|
|||
|
|
account.Protocol = "https"
|
|||
|
|
account.GatewayHost = "openapi.alipay.com"
|
|||
|
|
account.AppId = "<-- 请填写您的AppId，例如：2019022663440152 -->"
|
|||
|
|
account.SignType = "RSA2"
|
|||
|
|
account.AlipayPublicKey = "<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->"
|
|||
|
|
account.MerchantPrivateKey = "<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->"
|
|||
|
|
|
|||
|
|
kernel.InitClient(account)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
func main() {
|
|||
|
|
result, _ := kernel.Execute("alipay.trade.create", nil, getBizParams(time.Now().Format("2006-01-02 15:04:05")))
|
|||
|
|
fmt.Println(result)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func getBizParams(outTradeNo string) map[string]string {
|
|||
|
|
bizParams := map[string]string{
|
|||
|
|
"subject": "phone6 16G",
|
|||
|
|
"out_trade_no": outTradeNo,
|
|||
|
|
"total_amount": "0.10",
|
|||
|
|
"buyer_id": "2088002656718920",
|
|||
|
|
"extend_params": getHuabeiParams(),
|
|||
|
|
}
|
|||
|
|
return bizParams
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func getHuabeiParams() string {
|
|||
|
|
extendParams := map[string]string{
|
|||
|
|
"hb_fq_num": "3",
|
|||
|
|
"hb_fq_seller_percent": "3",
|
|||
|
|
}
|
|||
|
|
byt, _ := json.Marshal(extendParams)
|
|||
|
|
return string(byt)
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 文档
|
|||
|
|
|
|||
|
|
[Alipay Easy SDK](./../README.md)
|