README

This plugin comes with an interface in which you can create and manage your Ingenico configurations.

Features

This module comes with the following features:

Simple and secure way to configure and process your payments
Automatically fetch the configured payment providers from your Ingenico account
You can set default currency to be displayed on the payment page
You can configure and manage multiple Ingenico accounts for your site
Redirect visitors to a target landing page after a successful payment
Define admin and user permissions

Requirements

This plugin requires Craft CMS 3.5.0 or later.

Installation

To install the plugin, follow these instructions.

Open your terminal and go to your Craft project:
```
 cd /path/to/project
```

Composer to load the plugin:

 composer require ip-craft/ingenico-gateway-pro

In the Control Panel, go to Settings → Plugins and click the “Install” button for Ingenico gateway Pro.

Configuring Ingenico gateway Pro

After installation, you can add your Ingenico (Ogone) configurations in the control panel located at: /admin/ingenico-gateway-pro/configurations

Steps to use the plugin after installing:

Manage configurations

Once you install the plugin you will receive the ‘Manage Ingenico configuration’ screen in which you can manage all your Ingenico configurations. To create new configurations, simply click on the ‘+ New configuration’ button.

Create configurations

This is the create configuration screen, here you can add the required Ingenico account details like PSPID, Default currency, Post payment redirection, sha_ap and sha_bp.

Activate/Deactivate Configurations

From the ‘Manage Ingenico configuration’ page you can activate and deactivate the required configuration by clicking the ‘Activate’ or ‘Deactivate’ in the Activate/Deactivate column. Only one configuration can be active at a time.

In order to test if your configuration is working properly, you can use the test payment functionality. Follow the next steps to achieve this goal:

Click on the ‘Make test payment’ sub menu from the left navigation bar and fill in the dummy Order Id and Price fields
Click on ‘Make payment’, this will redirect you to the Ingenico payment screen
Select the required payment provider, add the payment details and confirm the payment
After confirmation, you will be redirected to the defined post payment redirection page

User permissions

In this section you can define the required permissions necessary for a user to have access.

How to use (Programatically):

Payment request Add the use statement to your class - use ipcraft\ingenicogatewaypro\IngenicoGatewayPro;

Access beginTransaction function and pass values Template order id, currency, price. As shown below -

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

Post payment handle transaction

Once payment is done will send all the payment details trough the post payment redirection url // post-payment-redirection-url?orderID=XXXXXXXXXXX&currency=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
You can get all the details as shown bellow

$data = $_REQUEST;

$orderId = $data['orderID'];
$currency = $data['currency'];
$status = $data['STATUS'];
$cardNumber = $data['CARDNO'];
$paymentId = $data['PAYID'];
$brand = $data['BRAND'];
$error = $data['NCERROR'];

Support

Get in touch with us via the mail Ingenico gateway Pro Support mail or by creating a Github issue

Roadmap

Recurring payments
Complete and partial refunds
Webhooks

Brought to you by Infanion

ip-craft / ingenico-gateway-pro

Maintainers

Details