搜索ifthenpay / magento2
Ifthenpay 网关模块
Requires
- php: >=7.4
README
简介
这是 Magento 2 电子商务平台的 Ifthenpay 插件。
多银行 是一种葡萄牙支付方式，允许客户通过银行参考号进行支付。此模块将允许您生成一个支付参考号，客户可以使用该参考号在 ATM 或网上银行服务中支付其订单。此插件使用了葡萄牙几个网关/服务之一，IfthenPay。
MB WAY 是第一种通过智能手机和平板电脑进行购买和即时转账的跨行解决方案。
此模块将允许您向客户手机发送付款请求，并且他可以在 MB WAY App 服务上授权其订单的支付。此模块使用了葡萄牙几个网关/服务之一，IfthenPay。
Payshop 是一种葡萄牙支付方式，允许客户通过 Payshop 参考号进行支付。此模块将允许您生成一个支付参考号，客户可以使用该参考号在 Payshop 代理或 CTT 支付其订单。此模块使用了葡萄牙几个网关/服务之一，IfthenPay。
信用卡 此模块将允许您通过 Visa 或 MasterCard 生成付款，客户可以使用该卡支付其订单。此模块使用了葡萄牙几个网关/服务之一，IfthenPay。
Cofidis Pay 是一种最多12期免息分期付款的支付解决方案，通过将购买分成多期来简化支付。此模块使用了葡萄牙几个网关/服务之一，IfthenPay。
需要与 Ifthenpay 签订合同。
更多信息请参阅 Ifthenpay。
加入 Ifthenpay 会员。
支持
如需支持，请在 Ifthenpay 支持 创建支持工单。
兼容性
使用下表检查 Ifthenpay 模块与您的在线商店的兼容性
安装
可以以两种方式安装此模块：使用 Composer 或手动将文件放置在 app/code/ 文件夹中。
使用 composer 安装
- 使用终端访问您的在线商店根目录。这可以通过SSH连接或使用您的网络主机终端完成。
- 依次执行以下命令：
composer require ifthenpay/magento2
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
手动安装
- 在Ifthenpay Github下载模块的最新版本。
- 如果不存在，请在您的在线商店根目录中创建以下文件夹：app/code/Ifthenpay/Payment，并将模块文件放入创建的文件夹中。
- 依次执行以下命令：
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
配置
安装模块后，它将在您的在线商店设置中可用。
选择销售，支付方式，当您找到Ifthenpay模块时，单击配置。
后台密钥
合同完成后，将提供Backoffice Key，由四组由连字符（-）分隔的数字组成。输入Backoffice Key（1）并单击保存（2）。
多银行
单击Multibanco（1）以展开配置选项。
Multibanco支付方式使用算法生成参考，如果不想为使用Multibanco支付的订单分配时间限制（以天为单位），则使用此方式。输入Backoffice Key时，将自动加载实体和子实体。配置支付方式。下方的图片显示了一个最小功能的配置示例。
- 启用 - 选择是时，激活支付方式，并在商店的结账页上显示。
- 标题 - 在结账时显示给消费者的标题，如果您选择不显示图标。
- 显示图标 - 选择是时，在结账时显示支付方式的图标。
- 激活回调 - 选择是时，在收到付款时更新订单状态。
- 实体 - 选择一个实体。您只能选择与Backoffice Key关联的实体之一。
- 子实体 - 选择一个子实体。您只能选择与先前选择的实体关联的子实体之一。
- 发送发票电子邮件 - 选择是时，消费者在收到付款时将自动收到订单发票的电子邮件。
- 最小金额 - （可选）只有当订单金额高于输入的金额时，才显示此支付方式。
- 最大金额 - （可选）只有当订单金额低于输入的金额时，才显示此支付方式。
- 限制支付到国家 - （可选）选择所有国家或仅选择特定的国家。留空以允许所有国家。
- 特定国家的支付 - （可选）只有当订单的配送目的地在所选国家时，才显示此支付方式。留空以允许所有国家。
- 排序顺序 - （可选）按升序顺序对结账页上的支付方式进行排序。数字越低，优先级越高。
单击保存以保存更改。
带动态引用的多银行
具有动态参考的Multibanco支付方式为每个订单生成参考，如果您想为使用Multibanco支付的订单分配时间限制（以天为单位），则使用此方式。输入Backoffice Key时，将自动加载实体和Multibanco Key。配置支付方式。下方的图片显示了一个最小功能的配置示例。
按照Multibanco支付方式的以下步骤操作：
- 实体 - 选择“Multibanco动态参考”作为实体。只有当您有与创建具有动态参考的Multibanco账户的合同时，此实体才会可用。
- Multibanco Key - 选择一个Multibanco Key。您只能选择与先前选择的实体关联的Multibanco Key之一。
- 最后期限 - 选择Multibanco参考有效期的天数。选择0将使Multibanco参考在生成当天23:59到期。留空将使Multibanco参考不会过期。
- 单击保存以保存更改。
MB WAY
MB WAY支付方式使用消费者提供的手机号码，向消费者的MB WAY智能手机应用程序生成支付请求，消费者可以接受或拒绝。在输入后台键时，MB WAY键会自动加载。配置支付方式。下面的图片显示了最小功能配置的示例。
- 启用 - 选择是时，激活支付方式，并在商店的结账页上显示。
- 标题 - 在结账时显示给消费者的标题，如果您选择不显示图标。
- 显示图标 - 选择是时，在结账时显示支付方式的图标。
- 显示倒计时 - (可选) 如果选择“是”，则在订单成功页面上显示支付时间限制的倒计时。如果有与一页结账模块冲突，请选择“否”。
- 激活回调 - 选择是时，在收到付款时更新订单状态。
- MB WAY键 - 选择一个MB WAY键。您只能选择与后台键关联的一个键。
- 发送发票电子邮件 - 选择是时，消费者在收到付款时将自动收到订单发票的电子邮件。
- 允许退款 - 如果选择“是”，则在信用通知页面上显示一个按钮，允许在线商店的管理员退款消费者支付的金额。
- 最小金额 - （可选）只有当订单金额高于输入的金额时，才显示此支付方式。
- 最大金额 - （可选）只有当订单金额低于输入的金额时，才显示此支付方式。
- 限制支付到国家 - （可选）选择所有国家或仅选择特定的国家。留空以允许所有国家。
- 特定国家的支付 - （可选）只有当订单的配送目的地在所选国家时，才显示此支付方式。留空以允许所有国家。
- 排序顺序 - （可选）按升序顺序对结账页上的支付方式进行排序。数字越低，优先级越高。
单击保存以保存更改。
信用卡
信用卡支付方式允许客户通过Ifthenpay网关使用Visa或Mastercard信用卡支付。在输入后台键时，Ccard键会自动加载。配置支付方式。下面的图片显示了最小功能配置的示例。
- 启用 - 选择是时，激活支付方式，并在商店的结账页上显示。
- 标题 - 在结账时显示给消费者的标题，如果您选择不显示图标。
- 显示图标 - 选择是时，在结账时显示支付方式的图标。
- Ccard键 - 选择一个信用卡键。您只能选择与后台键关联的一个键。
- 发送发票电子邮件 - 选择是时，消费者在收到付款时将自动收到订单发票的电子邮件。
- 允许退款 - 如果选择“是”，则在信用通知页面上显示一个按钮，允许在线商店的管理员退款消费者支付的金额。
- 最小金额 - （可选）只有当订单金额高于输入的金额时，才显示此支付方式。
- 最大金额 - （可选）只有当订单金额低于输入的金额时，才显示此支付方式。
- 限制支付到国家 - （可选）选择所有国家或仅选择特定的国家。留空以允许所有国家。
- 特定国家的支付 - （可选）只有当订单的配送目的地在所选国家时，才显示此支付方式。留空以允许所有国家。
- 排序顺序 - （可选）按升序顺序对结账页上的支付方式进行排序。数字越低，优先级越高。
单击保存以保存更改。
Payshop
Payshop支付方式生成可以在任何Payshop代理或关联商店支付的参考号。在输入后台键时，Payshop键会自动加载。配置支付方式。下面的图片显示了最小功能配置的示例。
- 启用 - 选择是时，激活支付方式，并在商店的结账页上显示。
- 标题 - 在结账时显示给消费者的标题，如果您选择不显示图标。
- 显示图标 - 选择是时，在结账时显示支付方式的图标。
- 激活回调 - 选择是时，在收到付款时更新订单状态。
- Payshop键 - 选择一个Payshop键。您只能选择与后台键关联的一个键。
- 截止日期 - 选择Payshop参考号的日期。选择1至99天之间的值。如果要使其不失效，请留空。
- 发送发票电子邮件 - 选择是时，消费者在收到付款时将自动收到订单发票的电子邮件。
- 最小金额 - （可选）只有当订单金额高于输入的金额时，才显示此支付方式。
- 最大金额 - （可选）只有当订单金额低于输入的金额时，才显示此支付方式。
- 限制支付到国家 - （可选）选择所有国家或仅选择特定的国家。留空以允许所有国家。
- 特定国家的支付 - （可选）只有当订单的配送目的地在所选国家时，才显示此支付方式。留空以允许所有国家。
- 排序顺序 - （可选）按升序顺序对结账页上的支付方式进行排序。数字越低，优先级越高。
单击保存以保存更改。
Cofidis Pay
Cofidis Pay支付方式允许消费者分期付款。在输入后台键时，Cofidis Pay键会自动加载。配置支付方式。下面的图片显示了最小功能配置的示例。
- 启用 - 选择是时，激活支付方式，并在商店的结账页上显示。
- 标题 - 在结账时显示给消费者的标题，如果您选择不显示图标。
- 显示图标 - 选择是时，在结账时显示支付方式的图标。
- 激活回调 - 选择是时，在收到付款时更新订单状态。
- Cofidis Pay键 - 选择一个Cofidis Pay键。您只能选择与后台键关联的一个键。
- 发送发票电子邮件 - 选择是时，消费者在收到付款时将自动收到订单发票的电子邮件。
- 最低金额 - (可选) 只为金额高于输入金额的订单显示此支付方式。重要提示：在Cofidis键选择时，此输入会更新为ifthenpay后台配置的值，在编辑时，不能低于ifthenpay后台指定的值。
- 最高金额 - (可选) 只为金额低于输入金额的订单显示此支付方式。重要提示：在Cofidis键选择时，此输入会更新为ifthenpay后台配置的值，在编辑时，不能高于ifthenpay后台指定的值。
- 限制支付到国家 - （可选）选择所有国家或仅选择特定的国家。留空以允许所有国家。
- 特定国家的支付 - （可选）只有当订单的配送目的地在所选国家时，才显示此支付方式。留空以允许所有国家。
- 排序顺序 - （可选）按升序顺序对结账页上的支付方式进行排序。数字越低，优先级越高。
单击保存以保存更改。
退款
MB WAY和信用卡支付方式允许通过订单信用通知页面对消费者支付的总额或部分金额进行退款。要退款消费者支付的金额，支付方式必须启用“允许退款”选项，并且订单必须有发票。要开始退款消费者支付的金额，请访问订单页面。
访问订单详情（1）。
单击发票（1），然后单击查看详情（2）。
单击信用凭证（1）。
可以编辑退款金额（1），然后单击更新（2），或者通过单击退款（3）进行退款。
确认退款金额，然后单击确定（1）。
将向发起退款的在线商店管理员用户的电子邮件发送包含安全令牌的电子邮件。
在电子邮件中输入收到的安全令牌（1），然后单击确定（2）。
所选金额将退还给消费者，并且订单状态将更新为已关闭。
多店
如果付模块与 Magento 2 的多店模式兼容，允许您为每个店铺配置不同的支付方式。此功能应用于网站范围，允许您为每个网站配置不同的支付方式。
要为每个店铺配置不同的支付方式，请访问模块的配置页面，并在左上角选择所需的网站（1）。
重要提示：在实施多店模式时，请不要配置默认配置，因为它将覆盖子店铺的网站。只能为每个网站配置不同的支付方式，无法为每个店铺视图配置不同的支付方式。
其他
请求创建额外账户
如果您已经有 Ifthenpay 账户但尚未签订您现在需要的支付方式，您可以向 Ifthenpay 自动提出请求。
要申请创建额外账户，请访问模块的配置页面，并单击“请求新账户”以签订您希望签约的支付方式。
如果您需要用于具有动态引用的 Multibanco 的账户，则“请求新账户”按钮将可在 Multibanco 支付方式的配置中找到（1）。
单击“请求新账户”后，将出现一个对话框，您可以通过单击“确定”（1）来确认操作。
因此，Ifthenpay 团队将添加支付方式到您的账户，更新模块中可用的支付方式列表。
重要提示：在请求信用卡支付方式的账户时，Ifthenpay 团队将在激活支付方式之前联系您，要求提供有关您的在线商店和业务的信息。
重置配置
如果您已获得新的后台密钥并希望将其分配给您的网站，但已分配了一个当前密钥，则可以重置模块的配置。在 Ifthenpay 模块配置中，单击“清除后台密钥”按钮（1），并通过单击“确定”确认操作。
注意，此操作将清除当前模块设置;
清除后台密钥后，您将提示重新输入后台密钥。
回调
重要提示：只有 Multibanco、MB WAY、Payshop 和 Cofidis Pay 支付方式允许启用回调。信用卡方法会自动更改订单状态。
回调是一种功能，当启用时，允许您的商店接收成功支付的通知。当启用时，在收到订单成功支付的通知后，Ifthenpay 服务器将与您的商店通信，将订单状态更改为“处理中”。您可以使用 Ifthenpay 支付而不启用回调，但您的订单不会自动更新状态更改。
如上所述在配置中，要启用回调，请访问模块的配置页面并启用“启用回调”选项。保存设置后，将执行将您的商店和支付方式与 Ifthenpay 服务器关联的过程，并将显示一个新元素（仅用于信息目的），显示回调状态（1）、防钓鱼密钥（2）和回调 URL（3）。
启用回调后，您无需采取任何进一步操作。回调已激活并正常运行。
定时任务
Cron 作业是一个在系统特定间隔自动执行的计划任务。Ifthenpay 模块提供了一个 cron 作业来检查支付状态，并在配置的时间内未支付的订单将被取消。下表显示了每种支付方式的时限，cron 作业将检查并取消在时限内未支付的订单。此时限只能用于具有动态引用的 Multibanco 和 Payshop 支付方式。Cofidis Pay 没有此功能，因为其批准时间不固定。
订单取消的cron作业每分钟运行一次。cron作业的配置选项可以在“ifthenpay_payment”组下的“Magento cron作业设置”页面找到。
要启动cron作业的执行，请访问Magento终端并运行以下命令
bin/magento cron:run --group ifthenpay_payment
日志
为了便于错误检测，Ifthenpay模块会记录其执行过程中发生的任何错误。日志随后保存在Magento的var/log/目录下的文本文件中。要访问日志，请转到Magento根目录下的var/log/文件夹并打开ifthenpay.log文件。
消费者用户体验
以下描述了在标准安装的Magento中使用Ifthenpay支付方式时的消费者用户体验，这可能会因为添加了一页结账扩展而发生变化。
在结账页面，选择配送方式后，消费者可以选择支付方式。
使用多银行支付订单
选择Multibanco支付方式（1），然后点击“下单”（2）。
将显示订单成功页面，显示实体、参考和需支付的金额。
如果Multibanco支付方式配置了动态参考，订单成功页面还将显示参考截止日期，以及实体、参考和需支付的金额。
使用 Payshop 支付订单
选择Payshop支付方式（1），然后点击“下单”（2）。
将显示订单成功页面，显示参考、有效期和需支付的金额。
使用 MB WAY 支付订单
选择MB WAY支付方式（1），填写手机号码（2），然后点击“下单”（3）。
如果启用了显示倒计时配置，订单成功页面将显示一个倒计时计时器，显示剩余付款时间。
倒计时计时器将自动在支付成功、用户拒绝（由MB WAY应用用户）、时间限制到期或错误的情况下更新支付状态。
如果成功，将显示成功消息。
如果用户拒绝，将显示拒绝消息。
如果时间限制到期，将显示到期消息。
如果无法与MB WAY应用通信或输入无效的手机号码，将显示错误消息。
如果出现错误、时间限制达到或在MB WAY应用中拒绝支付，消费者可以通过点击“重新发送MB WAY通知”来再次尝试。
如果MB WAY支付方式的配置有选项不显示倒计时，消费者将在MB WAY应用中收到通知，但倒计时和重新发送通知的按钮将不会显示在订单成功页面上。
使用信用卡支付订单
选择“信用卡”支付方式（1），然后点击“下单”（2）。
填写信用卡详情：卡号（1）、到期日期（2）、安全码（3）、持卡人姓名（4），然后点击“支付”（5）。
可以返回（6），取消支付。
支付处理完成后，将显示订单成功页面。
使用信用卡支付订单
选择“信用卡”支付方式（1），然后点击“下单”（2）。
填写信用卡详情：卡号（1）、到期日期（2）、安全码（3）、持卡人姓名（4），然后点击“支付”（5）。
可以返回（6），取消支付。
支付处理完成后，将显示订单成功页面。
使用 Cofidis Pay 支付订单
选择Cofidis Pay支付方式（1），然后点击“下单”（2）。
- 登录或，如果您没有账户，则使用Cofidis Pay注册
- 点击“继续”以使用Cofidis Pay注册；
- 或如果您已有Cofidis Pay账户，填写您的访问凭证并点击进入；
- 分期付款次数和账单及个人数据
- 选择您希望的分期付款次数；
- 验证支付计划的摘要；
- 填写您的个人和账单数据；
- 点击“继续”以继续；
- 条款和条件
- 选择“阅读并同意”以同意条款和条件；
- 点击“下一步”
- 协议正式化
- 点击“发送代码”；
- 协议正式化验证码
- 填写您手机上收到的验证码；
- 点击“确认代码”；
- 摘要和支付
- 填写您的信用卡详细信息（卡号、到期日和CVV），然后点击“验证”；
- 成功并返回商店
- 点击返回图标返回商店；
- 之后您将被重定向回商店；
您已经完成了ifthenpay Magento 2模块手册的末尾。祝贺您！