token 长期有效(卡 expire 时 Adyen 自动尝试 account updater)
初次创建 token 必须有用户在场(CIT)
首次支付时在 authorise 请求里加 storePaymentMethod=true,Adyen 返回 token (recurringDetailReference)。后续扣款用该 token + shopperReference 即可。
可用率 · 30 天窗口
关于这个 API
Recurring API 是 Adyen 订阅业务的核心。它解决两个问题:一是怎么安全地存储用户卡信息以便后续扣款(PCI 合规:自己存卡需要 PCI Level 1 认证,用 Adyen token 化能把责任转给 Adyen);二是 PSD2/SCA 合规的「重复支付例外」——欧洲法律要求大部分卡支付都要 3DS,但「订阅扣款」可以走例外,前提是初次有用户授权。这套机制涉及 recurring type 标记(区分用户驱动 vs 系统驱动)、shopperReference 绑定、和 account updater(卡过期自动更新)。是 SaaS、会员、流媒体业务的必备能力。
你可以做什么
- 1SaaS 月度订阅自动扣款
- 2会员续费
- 3存储用户卡信息以便一键复购
- 4PSD2/SCA 合规的重复支付
优劣对比
优点
- token 长期有效(卡 expire 时 Adyen 自动尝试 account updater)
- 支持多种 recurring 类型(CardOnFile、Subscription、UnscheduledCardOnFile)
- 和反欺诈引擎集成
注意事项
- 初次创建 token 必须有用户在场(CIT)
- token 不能跨 merchant 共享
示例请求
curl https://www.adyen.help/hc/en-us/community/topics/<endpoint>快速开始
首次支付时在 authorise 请求里加 storePaymentMethod=true,Adyen 返回 token (recurringDetailReference)。后续扣款用该 token + shopperReference 即可。
常见问题
订阅扣款不走 3DS 会被拒吗?+
依赖发卡行。Adyen 会自动加 recurring marker,大部分银行接受,少数仍要求 SCA(需要 step-up 流程)。
卡过期了 token 还能用吗?+
Adyen 的 account updater 服务会自动尝试拿最新卡号。如果发卡行不参与该服务,token 会失效。
技术细节
- 认证方式
- unknown
- 计费
- unknown
- 协议
- REST
- SDK
- java, python, javascript, php, csharp, go
- 响应时间
- 201 ms
- 上次巡检
- 2026/5/12 07:36:32
更多来自 Adyen 的 API
Adyen Balance Control API 在 Adyen 内部不同 merchant account 之间转移资金,用于资金集中管理和对账。
Adyen BIN Lookup API 根据卡号前 6-8 位(BIN)查询卡片信息:发卡行、国家、卡类型(debit/credit)、product 类型。
Adyen Checkout API 是面向新接入的现代支付 API,配套前端 drop-in 组件,自动适配 250+ 支付方式。
Adyen Checkout Utility API 提供 Checkout API 配套的辅助操作:originKeys 生成、payment methods 列表、status 查询。
Adyen Data Protection API 处理 GDPR/隐私法规相关操作:「被遗忘权」请求、PII 删除、shopper 数据导出。
Adyen Payments API 是其旗舰支付处理 API:跨多种支付方式(卡、本地支付、钱包)处理授权、捕获、退款。
Adyen Payouts API 把资金从 merchant account 出款到外部银行账户或卡,支持多种本地清算网络。
Adyen Test Card Service API 生成测试卡号用于沙箱环境的支付测试,覆盖各种 issuer 响应场景。