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