ip-craft/ingenico-gateway-pro

轻松设置和使用 Ingenico 付款,为您的 Craft 网站/Commerce 提供流畅、增强的客户体验

1.0.1 2021-09-28 13:28 UTC

This package is auto-updated.

Last update: 2024-09-28 20:45:41 UTC


README

此插件提供了一个界面,您可以在其中创建和管理您的 Ingenico 配置。

功能

此模块包含以下功能

  1. 简单且安全地配置和处理您的付款
  2. 自动从您的 Ingenico 账户获取配置的付款提供商
  3. 您可以为付款页面设置默认货币
  4. 您可以为您的网站配置和管理多个 Ingenico 账户
  5. 在付款成功后,将访客重定向到目标着陆页
  6. 定义管理员和用户权限

要求

此插件需要 Craft CMS 3.5.0 或更高版本。

安装

要安装插件,请按照以下说明操作。

  1. 打开您的终端并转到您的 Craft 项目

     cd /path/to/project
    
  2. Composer 来加载插件

     composer require ip-craft/ingenico-gateway-pro
    
  3. 在控制面板中,转到设置 → 插件,然后单击 Ingenico gateway Pro 的“安装”按钮。

配置 Ingenico gateway Pro

安装后,您可以在控制面板中添加您的 Ingenico(Ogone)配置,位置在:/admin/ingenico-gateway-pro/configurations

安装后使用插件的步骤

  1. 管理配置

    安装插件后,您将收到“管理 Ingenico 配置”屏幕,您可以在其中管理所有 Ingenico 配置。要创建新的配置,只需单击“+ 新配置”按钮。

  1. 创建配置

    这是创建配置屏幕,在此您可以添加所需的 Ingenico 账户详细信息,例如 PSPID、默认货币、付款后重定向、sha_ap 和 sha_bp。

  1. 激活/停用配置

    从“管理 Ingenico 配置”页面,您可以通过单击“激活”或“停用”列中的相应选项来激活和停用所需的配置。一次只能有一个配置处于活动状态。

  1. 为了测试您的配置是否正常工作,您可以使用测试付款功能。按照以下步骤实现此目标
  • 单击左侧导航栏中的“进行测试付款”子菜单,并填写模拟订单 ID 和价格字段
  • 单击“进行付款”,这将您重定向到 Ingenico 付款屏幕
  • 选择所需的付款提供商,添加付款详细信息并确认付款
  • 确认后,您将被重定向到定义的付款后重定向页面

  1. 用户权限

    在此部分中,您可以定义用户访问所需的基本权限。

如何使用(编程方式)

  1. 支付请求 在您的类中添加使用声明 - use ipcraft\ingenicogatewaypro\IngenicoGatewayPro;

访问 beginTransaction 函数并传递值 模板订单 ID、货币、价格。如下所示 -

$ingenicoService = IngenicoGatewayPro::$plugin->ingenicoGatewayProService;
$ingenicoService->beginTransaciton($orderId, $currency, $price);

  1. 付款后处理交易
  • 付款完成后,将通过付款后重定向 URL 发送所有付款详细信息 // post-payment-redirection-url?orderID=XXXXXXXXXXX¤cy=EUR&amount=XXXX&PM=XXXXXXXX&ACCEPTANCE=XXXXX&STATUS=X&CARDNO=XXXXXXXXXXXXXXXX&ED=XXXX&CN=XXXX&PAYID=XXXXXXXXXXX&NCERROR=X&BRAND=XXXXX&ECI=XX&SHASIGN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

  • 您可以根据以下示例获取所有详细信息

$data = $_REQUEST;

$orderId = $data['orderID'];
货币 = $data['currency'];
状态 = $data['STATUS'];
卡号 = $data['CARDNO'];
支付ID = $data['PAYID'];
品牌 = $data['BRAND'];
错误 = $data['NCERROR'];

支持

通过邮件 Ingenico gateway Pro 支持邮件 或通过 创建Github问题 与我们联系

路线图

  • 周期性付款
  • 完整退款和部分退款
  • Webhooks

Infanion 提供