C# 跨平臺的支付類庫ICanPay

隨着微軟的開源，愈來愈多的項目支持跨平臺，可是各類支付平臺提供的類庫，又老又不支持跨平臺，吐槽下，尤爲是微信，還有好多坑，因而ICanPay誕生了，今天就來說ICanPay是什麼，怎麼使用？

ICanPay是一個支持多商戶多種支付方式的跨平臺網關處理類庫，使用ICanPay能夠簡化訂單的建立、查詢、退款和接收網關返回的支付通知等操做。

目前支持的支付網關有：支付寶(Alipay)、微信支付(Wechatpay)、銀聯支付(Unionpay)

下面以支付寶爲例，其他兩種支付，請參考Wiki

1. 配置商戶數據

1.在Startup中添加商戶數據

services.AddICanPay(a =>
    {
        var gateways = new Gateways();

        var merchant = new Merchant
        {
             AppId = "",
             NotifyUrl = "",
             ReturnUrl = "",
             AlipayPublicKey = "",
             Privatekey = ""
         };

        gateways.Add(new AlipayGateway(merchant));

        return gateways;
    });

2.在Startup中使用ICanPay

app.UseICanPay();

以上就簡單的完成了對ICanPay的配置操做

2.支付

ICanPay支持多種支付方式，下面就來說解如何使用

1.獲取支付網關

private readonly IGateways gateways;

    public YourController(IGateways gateways)
    {
        this.gateways = gateways;
    }

2.建立訂單

var order = new Order()
    {
        Amount = 0.01,
        OutTradeNo = "訂單號",
        Subject = "測試",
    };

3.設置支付方式

var gateway = gateways.Get<AlipayGateway>(GatewayTradeType.Web);

4.支付

gateway.Payment(order);

特殊說明：GatewayTradeType.Barcode支付方式，須要再實現PaymentSucceed和PaymentFailed事件

3.異步通知

1.獲取支付網關

private readonly IGateways gateways;

    public NotifyController(IGateways gateways)
    {
        this.gateways = gateways;
    }

2.實現支付通知事件

PaymentNotify notify = new PaymentNotify(gateways);
    notify.PaymentSucceed += Notify_PaymentSucceed;
    notify.PaymentFailed += Notify_PaymentFailed;
    notify.UnknownGateway += Notify_UnknownGateway;

    private void Notify_PaymentSucceed(object sender, PaymentSucceedEventArgs e)
    {
        // 支付成功時時的處理代碼
        /* 建議添加如下校驗。
         * 一、須要驗證該通知數據中的OutTradeNo是否爲商戶系統中建立的訂單號，
         * 二、判斷Amount是否確實爲該訂單的實際金額（即商戶訂單建立時的金額），
         */
        if (e.GatewayType == typeof(AlipayGateway))
        {
            var notify = (Notify)e.Notify;
        }
    }

    private void Notify_PaymentFailed(object sender, PaymentFailedEventArgs e)
    {
        // 支付失敗時的處理代碼
    }

    private void Notify_UnknownGateway(object sender, UnknownGatewayEventArgs e)
    {
        // 沒法識別支付網關時的處理代碼
    }

3.接收支付通知

await notify.ReceivedAsync();

4.輔助接口

1.查詢

var notify = (Notify)gateway.Query(new Auxiliary
    {
            OutTradeNo = "訂單號"
    });

2.撤銷

var notify = (Notify)gateway.Cancel(new Auxiliary
    {
            OutTradeNo = "訂單號"
    });

3.關閉

var notify = (Notify)gateway.Close(new Auxiliary
    {
            OutTradeNo = "訂單號"
    });

4.退款

var notify = (Notify)gateway.Refund(new Auxiliary
    {
            OutTradeNo = "訂單號"，
            RefundAmount = 123,
            OutRefundNo = "退款單號"
    });

5.退款查詢

var notify = (Notify)gateway.RefundQuery(new Auxiliary
    {
            OutTradeNo = "訂單號"，
            OutRefundNo = "退款單號"
    });

6.對帳單下載

gateway.BillDownload(new Auxiliary
    {
            BillType = "trade",
            BillDate = "2017-10-31"
    });

以上就簡單的講解了如何使用ICanPay,若是有什麼問題，也能夠在Github上提問。
項目地址：ICanPay