README

Paytrail为Adobe Commerce（前身为Magento 2）提供的支付服务

警告：此模块与Markup/Paytrail模块不兼容。同时使用这两个模块将导致错误。

在安装任何扩展之前，请始终备份数据库和源代码。

此模块已在Adobe Commerce / Magento 2.4.7、2.4.6、2.4.5、2.4.4和2.3.X {community|commerce}版本上进行了测试。2.2.X版本的支持已结束，无法保证与旧版本的兼容性。

测试版本的Adobe Commerce系统要求可以在此处找到。

功能

此支付模块具有以下功能

Paytrail支付服务提供的支付方式
能够恢复和发货已取消的订单
支持延期付款（收款人等）
支持单个Magento 2实例内的多个商店
周期性付款

安装

该模块仅支持通过composer安装。

步骤

请确保您有Magento文件系统所有者权限。
在命令行中导航到您的Adobe Commerce根目录并输入
composer require paytrail/paytrail-for-adobe-commerce:<latest_version> --no-update
如果需要凭证，请输入您的Adobe Commerce市场访问密钥。
输入命令
composer update paytrail/paytrail-for-adobe-commerce
运行以下命令
php bin/magento module:enable Paytrail_PaymentService
php bin/magento setup:upgrade
php bin/magento setup:di:compile
bin/magento setup:static-content:deploy
导航到Adobe Commerce管理界面并选择商店 -> 商店配置 -> 销售配置 -> 支付方式 -> Adobe Commerce的Paytrail
输入您的凭证并启用该模块（测试凭证）
清除缓存

用法

模块设置可以在：商店 -> 配置 -> 销售配置 -> 支付方式 -> Adobe Commerce的Paytrail中找到

该模块具有以下设置

启用：定义是否启用支付方式 (输入：是 / 否)
在单独的页面上选择支付方式：在单独的页面上显示支付方式选择 (输入：是 / 否)
商户ID：您的Paytrail商户ID (输入：文本)
商户密钥：您的Paytrail商户密钥 (输入：密钥)
新订单状态：使用Paytrail支付的新订单的定制状态 (输入：选择)
通知电子邮件地址：如果订单取消后已处理付款，则将通知发送给商户，以便他们可以重新激活并发货订单 (输入：电子邮件地址)
适用国家的支付：允许来自所有国家或特定国家的支付 (输入：所有 / 特定)
特定国家的支付：如果之前的设置已设置为特定国家，则此列表可以定义允许的国家 (输入：选择)

设置周期性付款

该模块现在支持定期付款。请参阅定期付款的完整说明以进行设置。

退款

此支付模块支持在线退款。

步骤

导航到 销售 -> 订单 并选择您需要全额或部分退款的订单
从订单查看侧边栏选择发票
选择发票
选择贷项 memo
定义您想要退款的商品，并可选地定义调整费用
点击退款

已取消订单付款邮件通知

如果客户在完成付款后立即关闭浏览器窗口，但在返回商店之前，Adobe Commerce将订单状态保留为“待支付”。此状态有超时时间，因此如果支付确认在购买后8小时内未到达，Adobe Commerce将自动取消订单。Paytrail会通知Adobe Commerce已经完成的支付，但这可能需要超过8小时。

当确认最终完成时，Adobe Commerce将交易记录到订单中，并将订单状态更改为处理中。但由于在此期间库存可能已更改，商品仍然被取消。商户将收到一封关于已完成的支付的邮件通知，但他们必须手动访问该订单，确保商品仍然可用，然后点击“恢复订单”才能发货。

调整超时时间
8小时的超时时间可以在Adobe Commerce配置中进行调整。较长的期限可能允许Paytrail在取消之前确认订单，但也保留了该时间段内的库存。

转到 商店 -> 配置 -> 销售 -> 销售 -> 订单Cron设置
调整 待支付订单有效期（分钟） 的值到您喜欢。

订单状态

待支付
当客户被重定向到他们选择的支付提供商时，分配给订单。

待Paytrail付款服务
如果Adobe Commerce的Paytrail仍等待支付确认，则分配给订单。适用于发票，例如收款人。

处理中
一旦支付完成且商品准备发货，就分配给订单。

已取消
如果待支付状态已活跃超过8小时，则分配给订单。

可用的状态

处理中
疑似欺诈
待支付
待Paytrail付款服务
支付审查
待处理
挂起
完成
关闭
已取消

设置Apple Pay

支付模块支持Apple pay付款。

步骤

在Paytrail商户面板中启用Apple Pay。
使用关联文件验证您的域名
在管理面板中启用Apple Pay 商店 -> 配置 -> 销售 -> 支付方式 -> Apple Pay配置

多个商店

如果您有多个商店，您可以根据选择的商店设置不同的支付模块。在配置设置中，有一个商店视图的选择。

通过更改商店视图，您可以在Adobe Commerce实例中为每个商店定义不同的设置。

支付页面UI

版本2.2.0提供了支付页面的新UI。如果将启用新UI设置为否，则无需使用新UI，因为默认情况下旧UI仍然可用。

在管理面板中启用新UI界面 商店 -> 配置 -> 销售 -> 支付方式 -> 支付页面UI -> 启用新UI

对于新UI，个性化选项仅限于突出显示选定的支付方式并在支付方式上悬停。

某些提供商（如收款人）的舍入问题

在某些情况下，此模块可能会在订单数据中发送所谓的“四舍五入行”项，如果此值为负，则可能会导致错误（这已在Collector支付方式中观察到）。这与Adobe Commerce计算和四舍五入税费的方式以及该模块如何补偿总金额与单个项目总和之间可能出现的差异有关。

Adobe Commerce中有三种税费计算算法，可以在以下位置设置：商店 -> 配置 -> 销售 -> 税费 -> 基于以下方法的税费计算

基于单价
基于行总计
基于总计

如果描述的错误发生在基于总计的计算算法时，将其更改为基于单价可能可以实现无差异的税费计算。

注意：更改设置并不意味着基于单价的算法比基于总计或基于行总计的算法更好，所有三种算法在特定情况下都可能出现四舍五入问题，这些问题可以通过选择其他算法之一来解决。大多数情况下，算法的结果是相同的。

免责声明： 此开源模块旨在帮助商家开始使用我们的支付服务。然而，我们不提供任何关于模块将按预期工作或提供有限支持的保证或保证。使用风险自负。

paytrail / paytrail-for-adobe-commerce

维护者

详情