转载 C# 跨平台的支付类库ICanPay

分类:2017-11-27 12:00:27   239人阅读  评论   分享

随着微软的开源,越来越多的项目支持跨平台,但是各种支付平台提供的类库,又老又不支持跨平台,吐槽下,尤其是微信,还有好多坑,于是ICanPay诞生了,今天就来讲ICanPay是什么,怎么使用?


ICanPay是一个支持多商户多种支付方式的跨平台网关处理类库,使用ICanPay可以简化订单的创建、查询、退款和接收网关返回的支付通知等操作。


目前支持的支付网关有:支付宝(Alipay)、微信支付(Wechatpay)、银联支付(Unionpay)


下面以支付宝为例,其余两种支付,请参考Wiki(https://github.com/Varorbc/ICanPay/wiki)


一、配置商户数据


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的配置操作


二、支付


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事件


三、异步通知


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)

{

    // 支付成功时时的处理代码

    /* 建议添加以下校验。

     * 1、需要验证该通知数据中的OutTradeNo是否为商户系统中创建的订单号,

     * 2、判断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();


四、辅助接口


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(https://github.com/Varorbc/ICanPay)

分享到: