开发者指南:全新 iDEAL
内容提要
iDEAL 2.0是荷兰流行的支付方式的升级版,引入了新功能,如集中支付页面和消费者保存交付细节和首选账户的能力。现有的支付集成必须在2025年4月1日之前进行更新。开发人员需要根据类型(仅API、插件、Web Drop-in和组件、iOS和Android SDK)对其集成进行更改。商家可以在其客户区激活iDEAL 2.0。更新后的iDEAL允许存储购物者的首选银行和银行识别代码(BIC)。可以在新的沙盒环境中进行测试。iDEAL 2.0旨在提升购物者的支付体验并简化集成过程。
延伸解读
合规截止日期与影响范围
文章明确指出,所有现有的iDEAL支付集成必须在2025年4月1日前更新,这是一项强制性的合规变更。无论商家使用API、插件、Web Drop-in、组件还是移动端SDK,都需要根据集成类型进行相应调整。未及时更新的集成可能无法继续处理iDEAL支付,影响荷兰市场的交易。因此,开发团队应尽早规划升级,并在测试环境中验证,以避免业务中断。
不同集成类型的具体改动
对于仅API集成,开发者需从结账页面移除银行列表,并直接调用Adyen Checkout /payments API发起支付,无需传递issuer参数。使用插件的商家需升级到指定版本,如Magento v9.6.0+或Salesforce Commerce Cloud v24.3.0+。Web Drop-in和组件需升级Adyen Web库至v5.65.0或更高。iOS和Android SDK需使用2024年7月后发布的版本。Hosted Checkout则无需更改。
新功能:保存首选银行与BIC
iDEAL 2.0允许存储购物者的首选银行和银行识别代码(BIC),从而在后续支付中直接重定向到该银行,跳过银行选择步骤。此功能仅适用于Advanced Flow集成。要启用,需在客户区配置Authorization Webhook,勾选“Include Bank Account Details”选项。支付完成后,从Webhook中提取BIC并存储,下次支付时在请求中设置issuer字段即可。若购物者更换银行,则发起不带issuer的支付,由iDEAL页面处理选择。
测试与激活步骤
在Adyen TEST环境中,新的iDEAL 2.0支付方式已与旧版并列配置。开发者需先更新集成,然后在客户区激活iDEAL 2.0。测试时,在银行选择页面选择“TESTNL2A” issuer以进入测试页面,不同场景会触发不同响应,可参考Adyen文档验证支付结果。在LIVE平台,配置已支持iDEAL 2.0,测试完成后商家可无缝切换,无需额外更改。
Q&A
iDEAL 2.0有哪些新功能?
iDEAL 2.0引入了集中支付页面、消费者保存交付细节和首选账户的能力,提升了支付体验。
开发者如何更新现有的iDEAL集成?
开发者需根据集成类型进行相应更改,所有现有集成必须在2025年4月1日之前更新。
iDEAL 2.0的银行选择流程有什么变化?
银行选择流程已移至新的iDEAL支付页面,结账页面需重定向至该页面进行支付。
商家如何在客户区激活iDEAL 2.0?
商家需登录客户区,选择iDEAL并激活新的支付方法以使用iDEAL 2.0。
iDEAL 2.0对开发者的集成过程有什么影响?
iDEAL 2.0简化了集成过程,开发者需更新集成以适应新的支付页面和流程。
如何在测试环境中验证iDEAL 2.0的集成?
开发者需在TEST环境中验证集成,选择“TESTNL2A”作为测试银行以模拟支付流程。