SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场axiom-payments

axiom-payments

通用与其它

查看项目

更新于 10-15 14:39

技能介绍

用途

axiom-payments 用于在 Apple 平台上接入真实世界支付。根据资料，当涉及实物商品、服务、捐赠、票务、会员卡、非接触式卡在场支付或购后订单跟踪时，必须使用本技能；它明确不适用于应用内购买（IAP）或数字内容。

主要能力

技能覆盖以下方向：

  • 在 iOS / iPadOS / macOS / Catalyst / visionOS / watchOS 应用中添加 Apple Pay
  • 在网站中添加 Apple Pay（Apple Pay JS 或 W3C Payment Request API）
  • 构建 Wallet 卡券（登机牌、活动门票、优惠券、会员卡、门店卡）
  • 在 iPhone 上接受非接触式卡支付（Tap to Pay on iPhone / ProximityReader）
  • 在 Wallet 中展示购后订单跟踪（Orders in Wallet、FinanceKitUI 添加订单辅助）
  • 发卡行或银行向 Wallet 配置银行卡（issuer extensions）
  • Apple Pay 商户 ID、处理证书、商户身份证书设置
  • Pass Type ID 或 Order Type ID 证书与 PKCS #7 签名链
  • Tap to Pay 托管授权（com.apple.developer.proximity-reader.payment.acceptance）
  • 涉及支付、IAP、Apple Pay、Wallet 或可接受使用准则的 App Review 被拒问题
  • 网页 Apple Pay 的域名验证（.well-known/apple-developer-merchantid-domain-association.txt）
  • 使用 Apple Pay 沙盒卡或沙盒测试账号进行测试

使用方式

技能以“症状 / 任务 → 参考文档”的快速索引组织，并提供决策树与简化路由。例如：

  • 判断该用 Apple Pay 还是 IAP → skills/apple-pay-vs-iap.md
  • 原生 Apple Pay → skills/apple-pay.md + skills/apple-pay-ref.md
  • 网页 Apple Pay → skills/apple-pay-web.md + skills/apple-pay-web-ref.md
  • Tap to Pay on iPhone → skills/tap-to-pay.md + skills/tap-to-pay-ref.md
  • Wallet 卡券 → skills/wallet-passes.md + skills/wallet-passes-ref.md
  • Orders in Wallet → skills/wallet-orders.md
  • 发卡行 / 银行卡配置 → skills/wallet-extensions-ref.md
  • 出现故障（无支付表单、商户验证失败、卡券无法导入、Tap to Pay 无法启用）→ skills/payments-diag.md

跨套件路由规则包括：数字内容或数字内容订阅应改用 axiom-integration 的 in-app-purchases.md；支付相关的 App Review 申诉流程可结合 axiom-shipping；证书与钥匙串机制可结合 axiom-security；Xcode 能力与描述文件机制可结合 axiom-build；设计规范可结合 axiom-design；Catalyst / macOS 与 watchOS 的通用模式分别结合 axiom-macos 与 axiom-watchos。

适用场景

适用于销售实物商品、服务、捐赠、票务、会员卡、非接触式刷卡收款、购后订单跟踪，以及发卡行银行卡配置等真实世界支付场景。

限制

资料明确列出以下不在覆盖范围：

  • 应用内购买（StoreKit 2）——应使用 axiom-integration 的 in-app-purchases.md 与 storekit-ref.md
  • FinanceKit 消费者银行功能（账户聚合、交易查询）——不覆盖，仅使用 FinanceKitUI 的添加订单辅助
  • PKSecureElementPass、交通卡、车钥匙——由发卡方控制，不属于商户开发者范畴
  • Tap to Present ID（MobileDocumentReader）——用于身份验证而非支付
  • 通用 NFC 读取（Core NFC）——属于不同框架

此外，资料中的反合理化条目提示：实物商品使用 IAP 会导致 App Review 被拒；数字内容必须使用 IAP；网页上若接受其他支付方式，必须至少同等显著地提供 Apple Pay；Tap to Pay 使用需单独表单申请的托管授权；卡券签名建议使用服务端库；Apple Pay Mark 不可作为按钮；沙盒与生产卡行为不同；商户 ID 不会过期而处理证书 25 个月过期；商户验证必须由服务端通过双向 TLS 调用，不能从浏览器调用。