X-Payments:Connecting Magento

From Qualiteam Help

Overview

This page contains guidelines on how to process payments in Magentobased store using X-Payments application.

Magento can be connected to X-Payments by using X-Payments connector for Magento. X-Payments Connector ensures correct implementation of the following tasks:

• Importing the data on active payment methods from X-Payments to Magento;
• Transferring cart and customer details from Magento to X-Payments;
• Redirecting the customer from Magento to X-Payments and back to Magento;
• Synchronizing transaction and order details between X-Payments and Magento.

System requirements

Installation

Install X-Payments connector from Magento connect Magento connect

Configuring X-Payments Connector

Before you can start using Magento together with X-Payments you must configure X-Payments Connector.

To configure X-Payments Connector:

1. Log in to the Magento Admin area.

2. Go to the X-Payments connector settings page (System menu -> Configuration -> X-Payments connector)

This will open the X-Payments Connector configuration page.

3. Define connection details.

• Store ID: Unique value generated in the X-Payments back-end for a particular store. This value allows X-Payments to correctly identify requests coming from this store.
• X-Payment URL: The URL of your X-Payments installation. Make sure the URL is specified correctly, otherwise the module will not be able to connect to X-Payments
• Encryption key: A key to encrypt requests that the store sends to X-Payments The key is generated in the X-Payments back-end.
• Decryption key: A key to decrypt responses and callback requests that the store receives from X-Payments The key is generated in the X-Payments back-end.
• Decryption key password: A password to decrypt the Decryption key. The password is generated in X-Payments back-office.
• IP addresses for X-Payments callbacks: A comma-separated list of X-Payments IP addresses that are used by X-Payments to send callback requests.
• Payment currency: Currency

4. Establish mapping rules.

Mapping rules are used to synchronize transaction statuses in X-Payments with statuses of respective Magento orders. To associate an X-Payments transaction status with an Magento order status, choose the order status from the drop-down box in the column on the right.

For example, if you associate the entry "Set order status for 'Charged' payment to" on the right with the value "Processed" from the drop-down box on the left, changing the status of an X-Payment transaction to "Charged" will automatically change the status of the respective order in Magento to "Processed".

5. Click the Save button.

Testing the module

To test the module settings and connection with X-Payments click the Test module button. If the module is configured properly, a 'Test transaction successfully completed' message is displayed at the top of the page.

Importing X-Payments payment methods to Magento

To be able to use the payment methods defined in X-Payments you should import information about them from X-Payments

First click the Request payment methods from X-Payments button, and X-Payments will return a list of payment methods available for this shopping cart.

After you have reviewed the list of available payment methods, click Import payment methods.