README

我们为Magento开发了一个支付模块，允许您通过我们的API在您的Magento商店接受支付。Magento是一个用PHP编写的开源电子商务平台，由Adobe拥有。

您可以通过电子邮件发送到help@scanpay.dk或在我们的IRC上聊天（libera.chat #scanpay）与我们联系。

安装

您需要PHP版本 >= 5.6，并启用php-curl。该模块可在Packagist找到。您可以使用Composer安装模块或手动上传文件。Magento建议您使用Composer。您可以在此处找到如何安装Composer的指南。

1. 导航到您的Magento文件夹并使用Composer下载模块
   composer require scanpay/magento2

2. 启用模块并清除静态视图文件
   php bin/magento module:enable Scanpay_PaymentModule --clear-static-content

3. 注册扩展
   php bin/magento setup:upgrade

4. 使用新模块重新编译您的Magento商店
   php bin/magento setup:di:compile

5. 验证扩展是否启用
   php bin/magento module:status

配置

在开始之前，您需要在我们的仪表板中生成一个API密钥（此处）。请始终保持您的API密钥私密和安全。

1. 进入您的Magento管理员界面，导航到商店 > 配置 > 销售与 > 支付方式。
2. 找到名为"Scanpay"的支付方式并启用它。
3. 在"API密钥"字段中输入您的API密钥。
4. 复制"Ping URL"字段的内容，并将其插入到我们的仪表板中的"Ping URL"字段（此处）。

文件夹层次结构

/view

该/view文件夹定义了模块的布局和javascript。实际向客户展示的HTML表单可以在/view/frontend/web/template/payment/form.html中找到。

/view/frontend/web/js/view/payment/method-renderer/scanpaypaymentmodule.js定义了客户下订单时运行的javascript。

此javascript创建订单并向包含订单ID的/Controller/Payment/GetPaymentURL.php发起AJAX请求。

/Controller

该/Controller文件夹定义了公开提供的PHP页面。它由/etc/frontend/routes.xml中定义的URL提供服务。/Controller/Payment/GetPaymentURL.php从Magento收集订单参数并使用/Model/ScanpayClient.php向Scanpay API发送请求。成功后，它将返回一个支付URL，该URL将重定向到网络商店客户。

/Model

该/Model文件夹定义了由其他PHP文件使用的实用类。例如，它包含ScanpayClient.php，它使用PHP-curl对Scanpay API进行实际http请求。

/etc

该/etc文件夹定义了模块依赖、模块配置、模块命名和管理面板模块配置的布局。