Merge pull request #615 from ArtisanCloud/develop

由于有用户遇见之前的转账接口失效，微信使用了新的转账场景功能，
添加商户转账功能 https://pay.weixin.qq.com/doc/v3/merchant/4012716434

Author: Matrix-X

src/payment/application.go

@@ -12,6 +12,7 @@ import (
 	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/apply4Sub"
 	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/base"
 	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/bill"
+	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/fundApp"
 	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/jssdk"
 	kernel2 "github.com/ArtisanCloud/PowerWeChat/v3/src/payment/kernel"
 	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/merchant"
@@ -50,6 +51,7 @@ type Payment struct {
 	RedPack       *redpack.Client
 	Transfer      *transfer.Client
 	TransferBatch *transfer.BatchClient
+	FundApp       *fundApp.Client
 	Reverse       *reverse.Client
 	ProfitSharing *profitSharing.Client
 
@@ -200,6 +202,11 @@ func NewPayment(config *UserConfig) (*Payment, error) {
 		return nil, err
 	}
 
+	//-------------- FundApp --------------
+	app.FundApp, err = fundApp.RegisterProvider(app)
+	if err != nil {
+		return nil, err
+	}
 	//-------------- Reverse --------------
 	app.Reverse, err = reverse.RegisterProvider(app)
 	if err != nil {
@@ -284,6 +291,8 @@ func (app *Payment) GetComponent(name string) interface{} {
 		return app.RedPack
 	case "Transfer":
 		return app.Transfer
+	case "FundApp":
+		return app.FundApp
 	case "Reverse":
 		return app.Reverse
 	case "ProfitSharing":

src/payment/fundApp/client.go

@@ -0,0 +1,42 @@
+package fundApp
+
+import (
+	"context"
+	"github.com/ArtisanCloud/PowerLibs/v3/object"
+	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/fundApp/request"
+	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/fundApp/response"
+	payment "github.com/ArtisanCloud/PowerWeChat/v3/src/payment/kernel"
+
+	"net/http"
+)
+
+type Client struct {
+	*payment.BaseClient
+}
+
+func NewClient(app *payment.ApplicationPaymentInterface) (*Client, error) {
+	baseClient, err := payment.NewBaseClient(app)
+	if err != nil {
+		return nil, err
+	}
+	return &Client{
+		baseClient,
+	}, nil
+}
+
+// 发起转账
+// https://pay.weixin.qq.com/doc/v3/merchant/4012716434
+func (comp *Client) TransferBills(ctx context.Context, data *request.RequestTransferBills) (*response.ResponseTransferBills, error) {
+
+	result := &response.ResponseTransferBills{}
+
+	params, err := object.StructToHashMap(data)
+	if err != nil {
+		return nil, err
+	}
+
+	endpoint := comp.Wrap("/v3/fund-app/mch-transfer/transfer-bills")
+	_, err = comp.SafeRequestV3(ctx, endpoint, nil, http.MethodPost, params, nil, result)
+
+	return result, err
+}

src/payment/fundApp/provider.go

@@ -0,0 +1,11 @@
+package fundApp
+
+import (
+	"github.com/ArtisanCloud/PowerWeChat/v3/src/payment/kernel"
+)
+
+func RegisterProvider(app kernel.ApplicationPaymentInterface) (*Client, error) {
+
+	return NewClient(&app)
+
+}

src/payment/fundApp/request/requestTransferBills.go

@@ -0,0 +1,22 @@
+package request
+
+type RequestPayTransferToPocket struct {
+}
+
+type TransferSceneReportInfo struct {
+	InfoType    string `json:"info_type,omitempty"`
+	InfoContent string `json:"info_content,omitempty"`
+}
+
+type RequestTransferBills struct {
+	Appid                    string                    `json:"appid,omitempty"`
+	OutBillNo                string                    `json:"out_bill_no,omitempty"`
+	TransferSceneId          string                    `json:"transfer_scene_id,omitempty"`
+	Openid                   string                    `json:"openid,omitempty"`
+	UserName                 string                    `json:"user_name,omitempty"`
+	TransferAmount           int                       `json:"transfer_amount,omitempty"`
+	TransferRemark           string                    `json:"transfer_remark,omitempty"`
+	NotifyUrl                string                    `json:"notify_url,omitempty"`
+	UserRecvPerception       string                    `json:"user_recv_perception,omitempty"`
+	TransferSceneReportInfos []TransferSceneReportInfo `json:"transfer_scene_report_infos,omitempty"`
+}

src/payment/fundApp/response/responseTransferBills.go

@@ -0,0 +1,18 @@
+package response
+
+import (
+	"github.com/ArtisanCloud/PowerWeChat/v3/src/kernel/response"
+	"time"
+)
+
+// https://work.weixin.qq.com/api/doc/90000/90135/90278
+
+type ResponseTransferBills struct {
+	response.ResponsePayment
+	OutBillNo      string    `json:"out_bill_no"`
+	TransferBillNo string    `json:"transfer_bill_no"`
+	CreateTime     time.Time `json:"create_time"`
+	State          string    `json:"state"`
+	FailReason     string    `json:"fail_reason"`
+	PackageInfo    string    `json:"package_info"`
+}