Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明

  • A+
所属分类:.NET技术
摘要

     最近一个国外的电商项目,需要对接支付功能,国内的支付一般使用微信支付、支付宝、银联等等,但国际上一般使用Paypal、Skrill、BrainTree、Stripe等,经过内部综合考量所以最后选择使用 Stripe支付。

     最近一个国外的电商项目,需要对接支付功能,国内的支付一般使用微信支付、支付宝、银联等等,但国际上一般使用Paypal、Skrill、BrainTree、Stripe等,经过内部综合考量所以最后选择使用 Stripe支付。

Stripe的对接相对还是比较简单的,只是相关的文档是英文的,且国内和国外的思想不一样,看文档不是很方便。

做为技术人员这里我将对接中所遇到的问题和解决方法汇总,希望能对开发人员有所帮助。

一:Stripe支付介绍

Stripe支付国际支付还是非常有名气的,具体的介绍下面的一些说明:

  1. 中文官网:https://stripe.com/zh-cn-us
  2. Stripe国际支付简介:点击打开
  3. Stripe支付对接还是非常方便的。
  4. Stripe支付功能也还是很强大的包括支付、账单、订阅等等。

二:Stripe技术对接

  1. 对接前的准备工作
    • 需要去官网申请一个账号,好像是国内的银行卡不好申请。具体如何申请还请百度搜索下,我这里就不赘述了。
    • 申请好以后在后台拿到测试的公钥和私钥。
    • 需要申请HTTPS证书,这个异步通知的接口需要提供HTTPS的域名。
    • 官网接口文档,共区分后端、前端、ios和安卓。
    • 其它的一些使用文档:点击查看
  2. 支付对接方式说明:共有2中方式。
    • 方式一:使用Stripe的支付页面进行支付(官方名称:CheckOut)。
      • 这种分2种情况:
        • 跳转到Stripe的支付页面进行支付,这种类似于支付宝的对接,需要跳转到支付宝的支付页面。Stripe的支付页面效果图如下。
        • Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明
        • 自己的页面构建一个Stripe的支付,这种类似于微信公众号的支付。
    • 方式二:自己做支付页面,通过接口的方式进行支付。
      • 官网给出了很多HTML示例效果,可下载后自己修改下。点击查看示例效果
      • 采用这种方式,输入信用卡等信息是Stripe通过js控制的,我们是拿不到用户输入的相关信息的,为了安全。
    • 不管是使用方式一和方式二,我们都无法获取用户输入的信用卡等信息。
    • 推荐使用方式一对接,有以下几点:
      • 用户在Stripe输入银行卡信息,用户感觉要更加安全。
      • 减少不必要的开发工作,因为自己做的收银页面没法和Stripe的比较。
  3. 下面所有的流程主要是使用跳转到Stripe支付页面支付。
  4. 简单的流程说明
    • 用户点击页面上的“支付”按钮。
    • 通过js调用后台的接口,接口中要调用Stripe的接口创建支付的会话(Session),调用Stripe接口之前需要设置一些数据,包括支付金额、支付方式等等,这个后面说明。调用接口成功则Stripe会返回一个SessionId,将该值返会给前端。
    • 前端拿到SessionId以后,带上改参数跳转到Stripe的支付页面。
    • 用户如果取消支付或支付成功,则跳转到创建Session配置的取消地址和支付成功跳转地址。
    • 支付成功或其他的一些事件,Stripe会异步通知我们支付结果。
    • 上面这几步骤是大致的流程,还请有多的细节问题。
  5. 下面我们根据上面简单的流程进行一步步详细的说明。
  6. 下面的演示代码是:.NET MVC

三:发起支付

  1. 官网有个快速开始支付的说明文档,点击查看
  2. 做一个HTML页面,页面上需要引用Stripe的js文件和点击跳转到支付按钮。当然支付的页面上还有很多其他的一些东西,比如收货地址、商品信息等等。
    1.  
      <!DOCTYPE html>

    2.  
      <html>

    3.  
      <head>

    4.  
          <meta charset="utf-8" />

    5.  
          <title></title>

    6.  
          <script src="~/js/jquery-1.12.4.min.js"></script>

    7.  
          <script src="http://js.stripe.com/v3/"></script>

    8.  
       
    9.  
      </head>

    10.  
      <body>

    11.  
       
    12.  
         <button id="checkout-button">去付款</button>

    13.  
       
    14.  
          <script type="text/javascript">

    15.  
       
    16.  
              //创建一个stripe,里面的参数则是stripe申请的公钥,在后台能查看到,pk_开通的,加test表示是测试的

    17.  
              var stripe = Stripe('pk_test_xxx'); //输入自己的pk_test

    18.  
              var checkoutButton = document.getElementById('checkout-button');

    19.  
       
    20.  
              //支付按钮点击事件

    21.  
              checkoutButton.addEventListener('click', function () {

    22.  
       
    23.  
                  //调用后端的接口

    24.  
                  fetch('/home/CreateCheckoutSession', {

    25.  
                      method: 'POST',

    26.  
                  })

    27.  
                      .then(function (response) {

    28.  
                          return response.json();

    29.  
                      })

    30.  
                      .then(function (session) {

    31.  
                          //调用后端接口成功,得到sessionId,页面会在函数里面进行跳转

    32.  
                          return stripe.redirectToCheckout({ sessionId: session.id });

    33.  
                      })

    34.  
                      .then(function (result) {

    35.  
                        

    36.  
                          if (result.error) {

    37.  
                              alert(result.error.message);

    38.  
                          }

    39.  
                      })

    40.  
                      .catch(function (error) {

    41.  
                          console.error('Error:', error);

    42.  
                      });

    43.  
              });

    44.  
          </script>

    45.  
       
    46.  
       
    47.  
       
    48.  
      </body>

    49.  
       
    50.  
      </html>

     

  3. 上面的页面中需要一个后台调用Stripe来产生SessionId。
  4. 后端代码,VS上先在NuGet上引用第三方的包,名称:Stripe.net。
  5. 后端提供SessionId的代码如下
    1.  
      /// <summary>

    2.  
      /// 调用stripe创建支付的会话,成功则返回会话的Id,用于页面跳转

    3.  
      /// </summary>

    4.  
      /// <returns></returns>

    5.  
      [HttpPost]

    6.  
      public ActionResult CreateCheckoutSession()

    7.  
      {

    8.  
      try

    9.  
      {

    10.  
      // Stripe的私钥,在 Stripe后台能看到 sk开头的,_test则表示是用于测试环境的。

    11.  
      StripeConfiguration.ApiKey = "sk_test_xx"; //sk_test_xxx 这里需要修改

    12.  
       
    13.  
      //封装支付请求的数据,

    14.  
      //字段说明详见官网:https://stripe.com/docs/api/checkout/sessions/object

    15.  
      var options = new SessionCreateOptions

    16.  
      {

    17.  
      PaymentMethodTypes = new List<string>

    18.  
      {

    19.  
      "card" ,"alipay" //支持的付款方式

    20.  
      },

    21.  
      BillingAddressCollection= "required",//是否要收集帐单地址信息

    22.  
       
    23.  
      LineItems = new List<SessionLineItemOptions>

    24.  
      {

    25.  
      new SessionLineItemOptions

    26.  
      {

    27.  
      PriceData = new SessionLineItemPriceDataOptions

    28.  
      {

    29.  
      UnitAmount = 2000, //需要支付的金额

    30.  
      Currency = "usd",//支持的货币简写,具体见官网

    31.  
      ProductData = new SessionLineItemPriceDataProductDataOptions

    32.  
      {

    33.  
      Name = "支付的显示名称,或者是商品名称",

    34.  
      Images= new List<string>(){"http://www.angelasp.com/images/angellogo.gif" },

    35.  
      Description="支付的描述信息,可以是商品的描述等信息"

    36.  
      },

    37.  
      },

    38.  
      Quantity = 1,

    39.  
      },

    40.  
      },

    41.  
       
    42.  
      Mode = "payment",

    43.  
      SuccessUrl = "https://example.com/success", //支付成功以后跳转的URL地址

    44.  
      CancelUrl = "https://example.com/cancel",//用户取消支付以后跳转的URL地址

    45.  
      };

    46.  
       
    47.  
      options.PaymentIntentData = new SessionPaymentIntentDataOptions();

    48.  
      options.PaymentIntentData.Metadata = new Dictionary<string, string>

    49.  
      {

    50.  
      { "sn", "6735" }, { "attachmentValue", "6735" }, //传递的自定义参数,回调通知的时候会原样返回

    51.  
      };

    52.  
       
    53.  
      var service = new SessionService();

    54.  
      Session session = service.Create(options);

    55.  
       
    56.  
      return Json(new { id = session.Id });

    57.  
      }

    58.  
      catch (Exception ex)

    59.  
      {

    60.  
      throw ex;

    61.  
      }

    62.  
      }

     

  6. 上面前端HTML和后端的接口都处理好以后,点击页面上的那个去付款的按钮,则会跳转到Stripe的收银台页面(下图)。Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明
  7. Stripe的测试也非常方便,官方提供了很多测试的卡号,下面表格是我收集整理的一些。
  8. 卡号

    品牌

    CVC

    年月

    4242424242424242

    Visa

    任意3位数字

    大于当前时间的年月

    4000056655665556

    Visa (debit)

    任意3位数字

    大于当前时间的年月

    5555555555554444

    Mastercard

    任意3位数字

    大于当前时间的年月

    2223003122003222

    Mastercard (2-series)

    任意3位数字

    大于当前时间的年月

    5200828282828210

    Mastercard (debit)

    任意3位数字

    大于当前时间的年月

    5105105105105100

    Mastercard (prepaid)

    任意3位数字

    大于当前时间的年月

    378282246310005

    American Express

    任意4位数字

    大于当前时间的年月

    371449635398431

    American Express

    任意4位数字

    大于当前时间的年月

    6011111111111117

    Discover

    任意3位数字

    大于当前时间的年月

    6011000990139424

    Discover

    任意3位数字

    大于当前时间的年月

    3056930009020004

    Diners Club

    任意3位数字

    大于当前时间的年月

    36227206271667

    Diners Club (14 digit card)

    任意3位数字

    大于当前时间的年月

    3566002020360505

    JCB

    任意3位数字

    大于当前时间的年月

    6200000000000005

    UnionPay

    任意3位数字

    大于当前时间的年月

    信用卡的年月,填写大于当前时间的年月即可。

    Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明

  9. 在Stripe的支付页面填写好相关信息以后点击支付,如果没有问题的话就会支付成功。
  10. 支付成功以后可在Stripe的后台看到付款的金额和一些日志,日志包括事件、接口请求日志、订单数据等等。因为是测试的数据所以要先开启可查看测试数据,不然是看不到的,如何开启看下图。
  11. Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明
  12. 完成上面的步骤以后,则发起支付收款简单的流程没有问题下,下面说下如何接受Stripe异步通知。

四:接受异步通知

  1. Stripe支持很多事件的通知,例如Session创建完成、订单付款完成、退款等等,详见官网说明。事件类型说明
  2. 需要一个HTTPS的接口,如果没有证书可去阿里云等申请免费的证书。
  3. 在Stripe后台添加一个端点(接受通知的配置)见下图
  4. Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明
  5. 事件类型非常多,目前我们是做跳转支付,支付成功了通知我们,则选择:payment_intent.succeeded  事件
  6. 拿到验证端点的密钥,每个端点有独立的密钥,见下图Stripe支付介绍在asp.net mvc中开发对接,图文加代码说明
  7. 编写接受通知的接口代码,官网有英文的说明代码,下面我把代码整理了贴出来。
    1.  
      /// <summary>

    2.  
       
    3.  
      /// 支付成功的异步通知接口

    4.  
       
    5.  
      /// </summary>

    6.  
       
    7.  
      /// <returns></returns>

    8.  
       
    9.  
      [HttpPost]

    10.  
       
    11.  
      public ActionResult Notify()

    12.  
       
    13.  
      {

    14.  
       
    15.  
      var json = new StreamReader(HttpContext.Request.InputStream).ReadToEndAsync().Result;

    16.  
       
    17.  
      try

    18.  
       
    19.  
      {

    20.  
       
    21.  
                      //验证数据的来源

    22.  
       
    23.  
                      string endpointSecret = "whsec_XXXXX";//后台创建的端点签名密钥

    24.  
       
    25.  
                      var stripeEvent = EventUtility.ConstructEvent(json, Request.Headers["Stripe-Signature"], endpointSecret);

    26.  
       
    27.  
       
    28.  
       
    29.  
                      //stripeEvent.Type  则是不同的事件,具体则看你配置端点的时候,这个接口设置了那些事件

    30.  
       
    31.  
                      if (stripeEvent.Type == Events.PaymentIntentSucceeded)

    32.  
       
    33.  
      {

    34.  
       
    35.  
                          //支付成功的业务处理

    36.  
       
    37.  
                          var payModel = stripeEvent.Data.Object as PaymentIntent;

    38.  
       
    39.  
       
    40.  
       
    41.  
      decimal payAmount = payModel.Amount / 100M;  //支付的金额

    42.  
       
    43.  
                          string payPaySN = payModel.Id;//支付方的唯一订单号

    44.  
       
    45.  
                          string payCurrency = payModel.Currency;//支付的货币

    46.  
       
    47.  
       
    48.  
       
    49.  
                          //账单信息,如果创建Session的时候设置收集账单信息,则这里可以获取到

    50.  
       
    51.  
                          var billing = payModel.Charges.Data[0].BillingDetails;

    52.  
       
    53.  
      string billingName = billing.Name;

    54.  
       
    55.  
      string billingEmail = billing.Email;

    56.  
       
    57.  
      string billingPhone = billing.Phone;

    58.  
       
    59.  
      string billingCity = billing.Address.City;

    60.  
       
    61.  
      string billingCountry = billing.Address.Country;

    62.  
       
    63.  
      string billingLine1 = billing.Address.Line1;

    64.  
       
    65.  
      string billingLine2 = billing.Address.Line2;

    66.  
       
    67.  
      string billingPostalCode = billing.Address.PostalCode;

    68.  
       
    69.  
      string billingState = billing.Address.State;

    70.  
       
    71.  
       
    72.  
       
    73.  
                          //发起支付创建的自定义参数,这里具体根据自己的业务来

    74.  
       
    75.  
                          string orderSN = payModel.Metadata["sn"];

    76.  
       
    77.  
      string attachmentValue = payModel.Metadata["attachmentValue"];

    78.  
       
    79.  
       
    80.  
       
    81.  
                          //其它的一些业务处理,比如更新订单状态等等

    82.  
       
    83.  
       
    84.  
       
    85.  
       
    86.  
       
    87.  
                      }

    88.  
       
    89.  
      else if (stripeEvent.Type == Events.PaymentMethodAttached)

    90.  
       
    91.  
      {

    92.  
       
    93.  
      var paymentMethod = stripeEvent.Data.Object as PaymentMethod;

    94.  
       
    95.  
      Console.WriteLine("PaymentMethod was attached to a Customer!");

    96.  
       
    97.  
      }

    98.  
       
    99.  
      else

    100.  
       
    101.  
      {

    102.  
       
    103.  
      Console.WriteLine("Unhandled event type: {0}", stripeEvent.Type);

    104.  
       
    105.  
      }

    106.  
       
    107.  
       
    108.  
       
    109.  
      return Json(new { id = 1});

    110.  
       
    111.  
      }

    112.  
       
    113.  
      catch (StripeException)

    114.  
       
    115.  
      {

    116.  
      return Json(new { id =2 });

    117.  
       
    118.  
      }

    119.  
       
    120.  
      }

     

  8. 完成上面的步骤,就可以测试发起支付了和接受支付结果了。
  9. Stripe后台可以看到请求的日志记录,可以针对端点发送测试数据,这些对于调试程序还是很方便的,具体如何使用我就不多说了,都有中文的大家用心看下就懂了。
  10. 上线的时候需要将相关配置参数换成正式环境的。

以上只是我在研究Stripe支付的一点简单的总结,时间仓促很多细节还未深入详细说明。以上如有不正之处还望见谅,可给我留言讨论,谢谢!