payu/magento23-payment-gateway

为 Magento 2.3 官方 PayU 集成插件

1.1.4 2021-05-18 08:36 UTC

This package is auto-updated.

Last update: 2024-09-18 16:56:45 UTC


README

英文版本

Magento 2 2.3 版本的 PayU 模块

本模块采用 GPL 许可证。

如果您有任何问题或希望报告错误,请通过以下邮箱地址联系我们的技术支持: tech@payu.pl

目录

  1. 特性
  2. 要求
  3. 安装
  4. 配置
  5. 特性信息

特性

PayU 支付模块为 Magento 2 添加了 PayU 支付选项。该模块与 Magento 2 的 2.3 版本兼容。

支持以下操作

  • 在 PayU 系统中创建支付
  • 自动接收通知并更改订单状态
  • 接收或拒绝支付(如果已禁用自动接收)
  • 显示支付方式并在订单总结页面选择支付方式
  • 在订单总结页面直接进行卡支付
  • 保存卡信息并使用保存的卡支付
  • 支付重试
  • 在线创建退款(全部或部分)

该模块添加了两种支付方式

methods

  • PayU 支付 - 选择支付方式并跳转至银行或卡表单
  • 卡支付 - 在商店页面上直接输入卡号并使用卡支付

要求

注意:该模块仅与 REST API 类型的支付点一起工作(Checkout),如果您还没有在 PayU 系统中创建账户,请在生产系统中注册在沙盒中注册

  • PHP 版本需与安装的 Magento 2 版本相匹配
  • PHP 扩展: cURLhash

安装

使用 Composer

composer require payu/magento23-payment-gateway

将文件复制到服务器

  1. GitHub 存储库 下载最新版本的模块
  2. 解压缩下载的文件
  3. 通过 FTP 连接到服务器并将解压缩的内容复制到您的 Magento 2 商店的 app/code/PayU/PaymentGateway 目录。如果不存在该目录,请创建它。

使用 Composer 或通过控制台复制文件后,运行以下命令

  • php bin/magento module:enable PayU_PaymentGateway
  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy

配置

  1. 转到您的 Magento 2 商店的管理页面 [http://adres-sklepu/admin_xxx]。
  2. 转到 商店 > 配置
  3. 在左侧菜单的“配置”页面的“销售”部分,选择“支付方式”。
  4. 在可用的支付方式列表中,选择“PayU”或“PayU - Cards”以配置插件参数。
  5. 更改参数后,点击“保存配置”按钮。

参数

主要参数

支付点(POS)参数

支付点(POS)参数 - 测试模式(Sandbox)

当参数“测试模式(Sandbox)”设置为“是”时可用。

其他参数

特性信息

支付方式顺序

为了设置显示的支付方式图标顺序,请以逗号分隔支付方式的符号。 支付方式列表

支付重试

为了使用此选项,还需要在PayU中适当配置POS并禁用自动接收支付(默认自动接收是开启的)。为此,请登录到PayU面板,进入“电子支付”选项卡,然后选择“我的商店”和特定商店的支付点。自动接收支付的选项位于支付方式列表下方。

重复支付允许在Magento中为同一订单创建多个PayU支付。插件将自动接收第一个成功的支付,其余将被取消。从买家的角度来看,可以通过Magento中的订单列表进行重复支付(将显示“再次支付”链接)。买家还将自动收到包含此链接的电子邮件。这样,买家就有机会成功支付订单,即使第一次支付失败(例如,卡片余额不足,登录银行有问题等)。

保存卡信息

保存卡片允许登录用户记住卡片以供未来的支付使用。每个保存的卡片都会进行“令牌化”,而Magento不会以任何方式处理完整的卡片数据(卡片数据通过PayU托管的小部件提供),也不会将其保存到其卡片令牌数据库中(在使用之前,总是从PayU获取给定用户的最新令牌)。

为了正确运行此服务,需要进行额外的PayU配置,包括允许创建和获取令牌。此外,还可以设置使用保存卡片进行支付的认证规则(默认情况下,每个保存的卡片支付都需要输入CVV和3DS认证,但可以设置例如对于低于一定金额的交易不需要认证)。

买家可以在支付时保存卡片,通过在输入卡片信息时使用PayU小部件上的“使用并保存”选项。每个保存的卡片在第一次支付时都会进行强认证(CVV和3DS)。保存的卡片将在选择PayU卡支付订单后显示,并在用户账户中可见(在“我的保存卡片”选项卡中),那里也有删除卡片的选项。

货币转换

货币转换,也称为多货币定价(MCP),允许在不同于PayU结算货币的货币中向用户收费。例如,可以收取EUR,但从PayU收到PLN。货币转换基于Magento的功能,该功能允许“store-view”为“display currency”定义不同于“base currency”。这个选项比DCC(动态货币转换)更方便,因为卡片的货币价格会在每个产品上显示,这使得购买决策更容易(在DCC的情况下,货币金额只有在开始支付后才知道)。为了启动这项服务,需要

  • 从PayU获取mcpPartnerId参数(允许从PayU获取带有适当货币参数的课程表),
  • 在Magento中配置从PayU定期获取货币汇率。要启动和配置此服务,请联系PayU的销售经理。