README

为您的 Magento 2 网上商店提供 Checkout Finland 的支付方式

已废弃

此扩展已被废弃。现在所有功能都作为重新命名的 paytrail/paytrail-for-adobe-commerce 模块存在。建议升级到新模块。

升级到 Paytrail for Adobe Commerce

从该模块升级需要手动安装。

警告！删除 op-merchant-services/op-payment-service-for-magento-2 将导致使用 Checkout Finland 完成的支付无法通过 Magento 管理员退款。支付仍然可以通过 Paytrail 的 Extranet 退款。

按照此处找到的 paytrail/paytrail-for-adobe-commerce 的安装说明进行操作。
转到 Adobe Commerce 管理界面，选择 商店 -> 店铺配置 -> 销售配置 -> 支付方式 -> Checkout Finland
将启用改为否以禁用结账页面上的 Checkout Finland 支付方式

请注意，模块配置不会从 Checkout Finland 转移到 Paytrail for Adobe Commerce！您需要保存这些值并自行重新应用它们。这也适用于支付页面个性化设置！
某些类、函数和 CSS 类已重命名，任何第三方定制都将需要进行修订。

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

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

测试版本的 Magento 系统要求可以在 https://devdocs.magento.com/guides/v2.4/install-gde/system-requirements.html 上找到。

功能

此支付模块具有以下功能

Checkout Finland 支付服务提供的支付方式
恢复和发货已取消订单的能力
支持延迟付款（Collector 等。）
支持单个 Magento 2 实例内的多个商店

安装

通过 Composer

自 1.2.0 版本引入 Checkout Finland PHP-SDK 以来，该模块仅支持通过 composer 安装。

步骤

确保您具有 Magento 文件系统所有者权限。
在命令行中转到您的 Magento 根目录并输入
composer require checkout-finland/checkout-finland-for-magento-2:<最新版本> --no-update
如果需要凭证，请输入您的 Magento 市场访问密钥。
输入以下命令
composer update checkout-finland/checkout-finland-for-magento-2
运行以下命令
php bin/magento module:enable Op_Checkout
php bin/magento setup:upgrade
php bin/magento setup:di:compile
bin/magento setup:static-content:deploy
转到 Magento 管理界面，选择 商店 -> 店铺配置 -> 销售 -> 支付方式 -> Checkout Finland
输入您的凭证并启用该模块（测试凭证：375917 - SAIPPUAKAUPPIAS）
清除缓存

使用说明

模块设置可以在以下位置找到： 商店 -> 配置 -> 销售 -> 支付方式 -> Checkout Finland

模块有以下设置

启用：定义支付方式是否启用 （输入：是 / 否）
跳过银行选择：定义是否跳过银行选择 （输入：是 / 否）
商户 ID：您的 Checkout Finland 商户 ID （输入：文本）
商户密钥：您的 Checkout Finland 商户密钥 （输入：密钥）
新订单状态：使用 Checkout Finland 支付的新订单的定制状态 （输入：选择）
通知邮件地址：如果订单被取消后处理了支付，将向商户发送通知，以便他们可以重新激活并发货 （输入：电子邮件地址）
适用国家的支付：允许所有国家或特定国家的支付 （输入：所有 / 特定）
特定国家的支付：如果前面的设置已设置为特定国家，此列表可以定义允许的国家 （输入：选择）

退款

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

步骤

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

已取消订单支付电子邮件通知

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

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

调整超时时间
8 小时的超时时间可以在 Magento 配置中进行调整。较长的周期可能允许 Checkout Finland 在订单被取消之前确认订单，但它也保留了确切的库存时间。

转到 商店 -> 配置 -> 销售配置 -> 销售订单计划任务设置
根据您的需求调整 待付款订单有效期（分钟） 的值。

订单状态

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

待结账
如果Checkout Finland仍在等待付款确认，则分配给订单。适用于发票，如Collector。

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

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

可用状态

处理中
疑似欺诈
待付款
付款审核
待处理
挂起
完成
关闭
已取消
待结账

多个商店

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

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

某些提供商（Collector）的舍入问题

在某些情况下，此模块可能会在订单数据中发送所谓的“舍入行”项目，如果此值为负，则可能会导致错误（已观察到Collector方法）。这与Magento如何计算和舍入税费以及本模块如何补偿总金额与单个项目总和之间的可能不匹配有关。

在Magento中有三种税费计算算法，可以在 商店 -> 配置 -> 销售配置 -> 税费 -> 基于以下计算方法确定税费 中设置

基于单价
基于行总金额
基于总金额

如果计算算法是基于总金额，在出现描述的错误时，将其更改为基于单价可能会导致没有不匹配的税费计算。

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

op-merchant-services / op-payment-service-for-magento-2

维护者

详细信息