如何在Ionic 6应用中集成Samsung Pay对接Stripe支付

插件选型 #

目前没有Ionic官方出的Samsung Pay专属插件，社区可用的稳定方案组合如下：

• @awesome-cordova-plugins/samsung-pay：社区维护的Cordova/Capacitor桥接插件，最近更新适配了安卓13/14，兼容Ionic 6的Capacitor 3/4版本，不需要自己写原生桥接代码，是目前踩坑最少的选择。不要找个人发布的零散三星支付插件，大多停更3年以上，无法适配新的安卓版本，编译就会报错。
• @stripe/stripe-ionic：Stripe官方维护的Ionic SDK，原生层已经适配三星支付token的解析逻辑，不需要自己做额外的字段转换。

具体实现步骤 #

• 前置资质准备
  先到三星支付开发者后台注册你的应用，绑定应用包名、签名证书hash，拿到专属服务ID；同时到Stripe后台开通Samsung Pay支付渠道，获取Stripe公钥。debug调试阶段要单独把debug签名的hash加到三星后台，不然调试时调不起支付客户端。
• 依赖安装
  按照你的项目底层（Ionic6默认推荐Capacitor，老项目可能用Cordova）执行对应安装命令：

  # Capacitor 项目
  npm install @awesome-cordova-plugins/core @awesome-cordova-plugins/samsung-pay @stripe/stripe-ionic
  npx cap sync
  
  # Cordova 项目
  ionic cordova plugin add cordova-plugin-samsungpay
  npm install @awesome-cordova-plugins/core @awesome-cordova-plugins/samsung-pay @stripe/stripe-ionic
  

  安装完成后在app.module.ts中注入两个插件的服务，敏感配置（三星服务ID、Stripe公钥）建议从自己的业务服务端动态拉取，不要硬编码在前端代码里。
• 支付前环境校验
  不要上来就直接调起支付，先做三层校验：
  1. 判断当前运行平台是安卓，iOS设备直接隐藏三星支付入口
  2. 调用三星支付插件的isReady()方法，检查当前设备是否为三星机型、是否安装了支持支付的三星Pay版本、用户是否已经在三星Pay中绑定了可用银行卡
  3. 校验当前订单状态是待支付，避免重复提交
     任意校验不通过就直接降级展示普通银行卡支付入口，不要弹错误提示打扰用户。
• 获取三星Pay支付令牌
  校验通过后，构造支付请求参数（传入订单金额、货币类型、商户名称、订单号），调用插件的startPayment()方法调起三星Pay的验证界面，用户完成指纹/虹膜/支付密码验证后，插件会返回三星签发的一次性支付token。

  注意：拿到token后第一时间传到你的自有服务端做签名校验，确认token是三星官方签发、没有被篡改，不要直接把前端拿到的token传给Stripe，避免伪造支付请求。

• Stripe扣款流程
  服务端校验token合法后，调用Stripe接口将三星支付token转换为Stripe的PaymentMethod对象，后续按照Stripe标准支付流程创建PaymentIntent、确认支付即可，整个流程不需要前端接触用户敏感卡信息，符合PCI合规要求。

常见踩坑汇总 #

• 必须用三星真机调试，不管是安卓官方模拟器还是三星官方模拟器，都不支持三星Pay的支付调起，模拟器调试只会报环境错误
• 正式发布前一定要把应用正式签名的证书hash加到三星支付后台，不然上架后用户点击支付会报服务ID不匹配的错误
• 三星返回的支付token是一次性的，有效期只有10分钟左右，不要做本地缓存，支付失败要重新调起三星Pay拿新token
• Stripe侧的三星支付渠道需要手动在后台提交资质开通，没开通的情况下传token过去会直接返回支付方式不支持的错误

内容的提问来源于stack exchange，提问作者Team FOS