payu / magento23-payment-gateway
为 Magento 2.3 官方 PayU 集成插件
Requires
- php: >=7.1
- ext-json: *
- magento/framework: 102.0.*
- magento/module-checkout: 100.3.*
- magento/module-payment: 100.3.*
- magento/module-sales: 102.0.*
README
Magento 2 2.3 版本的 PayU 模块
本模块采用 GPL 许可证。
如果您有任何问题或希望报告错误,请通过以下邮箱地址联系我们的技术支持: tech@payu.pl。
- 如果您使用的是 Magneto 1.x 版本,请使用 1.x 版本的插件
- 如果您使用的是 Magneto >2.0.6, 2.1, 2.2 版本,请使用 >2.0.6, 2.1, 2.2 版本的插件
- 如果您使用的是 Magneto 2.4 版本,请使用 2.4 版本的插件
目录
特性
PayU 支付模块为 Magento 2 添加了 PayU 支付选项。该模块与 Magento 2 的 2.3 版本兼容。
支持以下操作
- 在 PayU 系统中创建支付
- 自动接收通知并更改订单状态
- 接收或拒绝支付(如果已禁用自动接收)
- 显示支付方式并在订单总结页面选择支付方式
- 在订单总结页面直接进行卡支付
- 保存卡信息并使用保存的卡支付
- 支付重试
- 在线创建退款(全部或部分)
该模块添加了两种支付方式
- PayU 支付 - 选择支付方式并跳转至银行或卡表单
- 卡支付 - 在商店页面上直接输入卡号并使用卡支付
要求
注意:该模块仅与 REST API
类型的支付点一起工作(Checkout),如果您还没有在 PayU 系统中创建账户,请在生产系统中注册或在沙盒中注册
安装
使用 Composer
composer require payu/magento23-payment-gateway
将文件复制到服务器
- 从 GitHub 存储库 下载最新版本的模块
- 解压缩下载的文件
- 通过 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
配置
- 转到您的 Magento 2 商店的管理页面 [http://adres-sklepu/admin_xxx]。
- 转到 商店 > 配置。
- 在左侧菜单的“配置”页面的“销售”部分,选择“支付方式”。
- 在可用的支付方式列表中,选择“PayU”或“PayU - Cards”以配置插件参数。
- 更改参数后,点击“保存配置”按钮。
参数
主要参数
支付点(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的销售经理。