Skip to content

Latest commit

 

History

History
172 lines (141 loc) · 6.57 KB

README.md

File metadata and controls

172 lines (141 loc) · 6.57 KB
Raw

wechat-sdk

最重要的事

如果在使用过程中存在任何bug，还请指出，非常感谢！

致谢

Jetbrains Tools

功能列表

小程序
Name Explain comment
GetUserPhoneForMini 小程序获取电话号码 客户端调用微信接口获取加密信息时不能在回调中再次调用登陆接口, 否则会让session_key失效
GetSessionKeyAndOpenId 通过小程序授权code获取session_key和用户openid
GetAccessTokenForMini 小程序获取AccessToken
GetUserInfoForMini 小程序获取用户基本信息
公众号
Name Explain comment
GetAppBaseAccessToken 公众号开发获取基础接口调用Access_Token 用于调用其他接口
GetAppOauthAccessToken 公众号开发通过code获取网页授权Access_Token 此Access_Token用于拉取用户信息, code只能用一次
RefreshOauthToken 公众号开发刷新网页授权Access_Token
GetAppUserInfo 公众号开发拉取用户信息 返回结果参考微信文档
CheckOauthToken 公众号开发校验网页授权Access_Token是否有效
微信支付
Name Explain comment
CloseOrder 关闭订单
DownloadBill 下载对账单
DownloadComment 拉取订单评论
DownloadFundFlow 下载资金账单
GetPublicKey 获取RSA加密公钥
RefundOrder 申请退款
RefundNotify 解析微信退款回调内容, 主要是对req_info解密
RefundQuery 退款查询
Report 向微信发送接口调用结果的报告, 包括接口调用时间
ReverseOrder 撤销订单
Transfers 企业付款到用户零钱
TransfersQuery 查询企业付款到用户零钱的结果
TransferBank 企业付款到银行卡 未测试
TransferBankQuery 查询企业付款到银行卡的结果 未测试
UnifiedMicro 扫码下单 如果需要传detail参数, 参数格式参照单品优惠活动detail字段列表说明
UnifiedOrder 统一下单: H5/APP/MWEB/NATIVE 返回给前端的唤起支付参数中, package = prepay_id=xxxxxxx
UnifiedQuery 下单结果查询
商户分账
Name Explain comment
ProfitSharing 申请分账(单次或多次) multiTag标志是否是多次分账
QueryProfitSharing 查询分账请求的结果 非分账的结果，而是分账申请的结果
AddProfitSharingReceiver 添加分账接收方
RemoveProfitSharingReceiver 删除分账接受方
FinishProfitSharing 完结分账 如果订单不需要(再)分账, 且剩余待分账金额不为0时, 调用本接口将剩余金额冻结给特约商户
ReturnProfitSharing 分账回退 对已分账的订单进行退款时，先调用本接口将金额从分账接收方回退给商户(非异步, 同步回传回退结果)
QueryProfitSharingReturn 回退结果查询 用于核实回退结果
ProfitSharingNotify 分账动帐通知 分账或分账回退成功后, 微信会将结果发送给商户, 通知结果包含加密信息, 此处解密密钥为ApiV3密钥。接口返回结果中忽略层级关系，对于需要的字段直接使用Get方法获取值。通知url在商户平台配置，详情参加分账动帐通知
现金红包
Name Explain comment
SendRedPack 发放现金红包
SendGroupRedPack 发放裂变红包
GetRedPackRecords 查询红包记录

Notice: NewPayer()必须传入所有需要使用的微信参数, 使用过程中所有请求接口都不需要加入appid/mch_id/ApiKey/secret/sign/ApiV3Key参数

Usage Example:

package main

import (
    "fmt"
    dev "github.com/pyihe/wechat-sdk"
)

func main() {
    var appId, mchId, apiKey, apiSecret string
    
    client := dev.NewPayer(dev.WithAppId(appId), dev.WithMchId(mchId), dev.WithApiKey(apiKey), dev.WithSecret(apiSecret))
    
    //unified order
    param := dev.NewParam()
    param.Add("nonce_str", "yourNonceStr")
    param.Add("body", "yourBody")
    param.Add("out_trade_no", "yourOutTradeNo")
    param.Add("total_fee", 1)
    param.Add("spbill_create_ip", "yourIp")
    param.Add("notify_url", "yourUrl")
    param.Add("trade_type", "JSAPI")
    result, err := client.UnifiedOrder(param)
    if err != nil {
        handleErr(err)
    }
    appId, _ = result.GetString("apppid")
    prepayId, _ := result.GetString("prepay_id")
    param = dev.NewParam()
    param.Add("appId", appId)
    param.Add("timeStamp", time.Now().Unix())
    param.Add("nonceStr", "nonceStr")
    param.Add("package", "prepay_id="+prepayId)
    param.Add("signType", "MD5")
    //use to evoke wechat pay 
    sign := param.Sign("MD5")


    //download bill
    param = dev.NewParam()
    param.Add("nonce_str", "yourNonceStr")
    param.Add("bill_date", "yourDate")
    param.Add("bill_type", "ALL")
    param.Add("tar_type", "GZIP")
    err := client.DownloadBill(param, "./bill")
    if err != nil {
        handleErr(err)
    }
    

    //get phone for mini program user
    result, err := client.GetUserPhoneForMini("code", "encryptedData", "iv")
    if err != nil {
    	handleErr(err)
    }
    var phone string
    if countryCode := result.Get("countryCode"); countryCode != nil && countryCode.(string) == "86" {
    	purePhone := result.Get("purePhoneNumber")
    	phone = purePhone.(string)
    } else {
    	phoneNumber := result.Get("phoneNumber")
    	phone = phoneNumber.(string)
    }
    fmt.Printf("user phone is %s\n", phone)
}
package main

import (
    "fmt"
    "net/http"
    
    dev "github.com/pyihe/wechat-sdk"
)

func main() {
    var appId, mchId, apiKey, apiSecret string
    
    client := dev.NewPayer(dev.WithAppId(appId), dev.WithMchId(mchId), dev.WithApiKey(apiKey), dev.WithSecret(apiSecret))
    
    //handle refund notify
    http.HandleFunc("/refund_notify", func(writer http.ResponseWriter, request *http.Request) {
        defer request.Body.Close()
        result, err := client.RefundNotify(request.Body)
        if err != nil {
            handleErr(err)
        }
        fmt.Printf("RefundNotify Result = %v\n", result.Data())
    })
    http.ListenAndServe(":8810", nil)
}