README

适用于 OXID eShop 6.5 及以上版本的 Adyen 集成。

文档

• 官方德语 Adyen 支付 OXID 文档。
• 官方英语 Adyen 支付 OXID 文档。

分支兼容性

• b-6.5.x 模块分支与 OXID eShop 编译 6.5 兼容

OXID 安装

• 参见官方文档

限制

• tbd

运行测试

警告：运行测试将重置商店。

需求

• 确保已配置 test_config.yml
  partial_module_paths: osc/adyen

  * ```
  activate_all_modules: true
  run_tests_for_shop: false
  run_tests_for_modules: true
  

• 为了运行代码ception 测试，需要可用的 selenium 服务器，有几种解决方案
  • 使用 OXID 官方 vagrant 箱环境。
  • 使用 OXID 官方 docker sdk 配置。
  • 使用其他预配置的容器，例如：image: 'selenium/standalone-chrome-debug:3.141.59'

运行

运行 phpunit 测试

vendor/bin/runtests

运行带有覆盖报告的 phpunit 测试（报告生成在 .../adyen/Tests/reports/ 目录中）

XDEBUG_MODE=coverage vendor/bin/runtests-coverage

默认方式运行 codeception 测试（主机：selenium，浏览器：chrome）

vendor/bin/runtests-codeception

使用特定主机/浏览器/测试组运行 codeception 测试示例

SELENIUM_SERVER_HOST=seleniumchrome BROWSER_NAME=chrome vendor/bin/runtests-codeception --group=examplegroup

Apple Pay (Dev) 集成

由于 Apple Pay 集成是最复杂的，以下是一些提示

Sandbox 测试者账户和测试信用卡

• 必须拥有 Apple 开发者账户
• 创建 Apple 沙盒测试者账户：https://developer.apple.com/apple-pay/sandbox-testing/
• 确保此测试者账户不在任何 Apple 设备上使用
• 使用您的沙盒测试者账户登录到您的测试 Apple 设备
• 将该测试信用卡号码添加到测试 Apple 设备上的钱包中
  • 添加一个有效的测试卡有一定难度，这个对我有效
    • 4123 4000 7332 0224
    • 到期日期：12/2025
    • CVV：863

Adyen 设置

• 商店的 Web 服务器需要提供域名关联文件：https://docs.adyen.com/payment-methods/apple-pay/web-drop-in?utm_source=ca_test#going-live
  • 下载并解压域名关联文件
  • 将其放在您的商店 Web 服务器上的 /.well-known/apple-developer-merchantid-domain-association 可达
  • 在我的开发设置中，我在头部 Content-Type: text/plain 遇到了问题
    • 我使用了 cloudflare ssh 隧道使我的本地 Web 服务器公开可达
    • cloudflare 代理没有设置 Content-Type: text/plain 头部
    • 使用 dyndns 服务使我的本地 Web 服务器可达对我来说解决这个问题有效
• 在 Home => 添加支付方式下点击 "添加更多"
  • 点击 "请求支付方式"
  • 搜索 Apple
  • 点击复选框
  • 点击 Adyen 的证书
  • 输入首选商户名称
  • 在商店网站下输入您的商店 Web 服务器上可到达的域名，包括 https://
• 在开发者 => API 凭证下点击 ws@Company.[你的 adyen 账户]
  • 在 "服务器设置 => 认证" 下点击 "生成 API 密钥"，复制并保存它
  • 在“客户端设置 => 认证”下点击“生成客户端密钥”，复制并保存它
  • 添加允许的域名：您的店铺网站服务器下的域名可达，包括 https://