ip-craft / ingenico-gateway-pro
轻松设置和使用 Ingenico 付款,为您的 Craft 网站/Commerce 提供流畅、增强的客户体验
Requires
- craftcms/cms: ^3.5.0
This package is auto-updated.
Last update: 2024-09-28 20:45:41 UTC
README
此插件提供了一个界面,您可以在其中创建和管理您的 Ingenico 配置。
功能
此模块包含以下功能
- 简单且安全地配置和处理您的付款
- 自动从您的 Ingenico 账户获取配置的付款提供商
- 您可以为付款页面设置默认货币
- 您可以为您的网站配置和管理多个 Ingenico 账户
- 在付款成功后,将访客重定向到目标着陆页
- 定义管理员和用户权限
要求
此插件需要 Craft CMS 3.5.0 或更高版本。
安装
要安装插件,请按照以下说明操作。
-
打开您的终端并转到您的 Craft 项目
cd /path/to/project
-
Composer 来加载插件
composer require ip-craft/ingenico-gateway-pro
-
在控制面板中,转到设置 → 插件,然后单击 Ingenico gateway Pro 的“安装”按钮。
配置 Ingenico gateway Pro
安装后,您可以在控制面板中添加您的 Ingenico(Ogone)配置,位置在:/admin/ingenico-gateway-pro/configurations
安装后使用插件的步骤
-
管理配置
安装插件后,您将收到“管理 Ingenico 配置”屏幕,您可以在其中管理所有 Ingenico 配置。要创建新的配置,只需单击“+ 新配置”按钮。
-
创建配置
这是创建配置屏幕,在此您可以添加所需的 Ingenico 账户详细信息,例如 PSPID、默认货币、付款后重定向、sha_ap 和 sha_bp。
-
激活/停用配置
从“管理 Ingenico 配置”页面,您可以通过单击“激活”或“停用”列中的相应选项来激活和停用所需的配置。一次只能有一个配置处于活动状态。
- 为了测试您的配置是否正常工作,您可以使用测试付款功能。按照以下步骤实现此目标
- 单击左侧导航栏中的“进行测试付款”子菜单,并填写模拟订单 ID 和价格字段
- 单击“进行付款”,这将您重定向到 Ingenico 付款屏幕
- 选择所需的付款提供商,添加付款详细信息并确认付款
- 确认后,您将被重定向到定义的付款后重定向页面
-
用户权限
在此部分中,您可以定义用户访问所需的基本权限。
如何使用(编程方式)
- 支付请求 在您的类中添加使用声明 - use ipcraft\ingenicogatewaypro\IngenicoGatewayPro;
访问 beginTransaction 函数并传递值 模板订单 ID、货币、价格。如下所示 -
$ingenicoService = IngenicoGatewayPro::$plugin->ingenicoGatewayProService;
$ingenicoService->beginTransaciton($orderId, $currency, $price);
- 付款后处理交易
-
付款完成后,将通过付款后重定向 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 提供