如何在Android平台开发类似PayPal、调用后可自主完成后续流程的SDK

核心设计逻辑 #

• 先明确和集成方的业务边界：提前定义好唯一触发节点，比如将触发节点定义为统一的初始化支付接口，集成方仅需要传入订单号、金额、币种等核心业务参数，调用后所有中间逻辑完全由SDK内部闭环处理，不需要集成方介入任何中间步骤。
• 上下文完全隔离：SDK内部维护独立的运行上下文，不污染集成方宿主应用的运行环境，避免和宿主的全局变量、页面路由、渲染环境产生冲突，SDK内部的所有操作都在隔离环境内完成。

分端实现方案 #

网页端JS SDK #

• 触发入口：暴露全局方法`PaySDK.initPayment(paymentParams, callbacks)
• 内部自动执行流程：
  1. 接口调用后，SDK自动向服务端发起订单合法性校验、签名校验，校验通过后用Shadow DOM自动渲染隔离的支付弹窗，不需要集成方提供任何DOM节点
  2. 后续支付方式选择、第三方渠道跳转、3DS安全校验、支付结果轮询全在SDK隔离环境内完成
  3. 流程结束后SDK自动销毁内部DOM、清理所有事件监听，仅通过预设的success/fail/cancel回调通知集成方最终结果

移动端SDK #

• 触发入口：Android端暴露PaySDK.initPayment(context, paymentParams, callback)，iOS端暴露+ (void)initPaymentWithParams:(PayPaymentParams *)params completion:(void(^)(PayResult *result))completion
• 内部自动执行流程：
  1. 接口调用后，SDK自动拉起独立的支付页面栈，Android用单独的Task栈管理、iOS用模态栈管理，不侵入宿主的页面路由逻辑
  2. 后续生物识别校验、第三方支付渠道跳转、结果校验全由SDK内部处理，不需要宿主做任何中间跳转适配
  3. 流程结束后SDK自动关闭内部页面栈，通过回调返回最终支付状态，不会把中间异常抛给集成方处理

核心能力保障 #

• 通信加密：签名加密逻辑完全内置，所有和服务端的通信自动加签验签，不需要集成方处理任何加密逻辑
• 异常兜底：网络错误、支付超时、用户取消、渠道异常等所有异常场景全由SDK内部处理，自动给用户弹出对应提示、清理内部资源，不需要集成方做额外的异常处理逻辑
• 兼容适配：SDK内部完成不同系统版本、不同宿主环境的兼容适配，集成方接入后不需要额外适配不同场景

集成方接入示例 #

// 网页端集成方仅需要实现以下代码，后续所有支付流程全由SDK自主完成
PaySDK.initPayment({
  orderId: '202406010001',
  amount: 129.9,
  currency: 'USD'
}, {
  onSuccess: (res) => {
    // 仅处理支付成功后的业务逻辑即可
  },
  onFail: (err) => {
    // 仅处理支付失败后的业务逻辑即可
  }
})

// Android端集成示例
PaySDK.INSTANCE.initPayment(this, new PaymentParams()
  .setOrderId("202406010001")
  .setAmount(129.9)
  .setCurrency("USD"), result -> {
    // 处理支付结果即可
});

内容的提问来源于stack exchange，提问作者Shubham mogarkar