Configuring Opayo by Elavon Module for osCommerce 2.3

From osCommerce Wiki
Revision as of 12:57, 25 March 2024 by Admin (talk | contribs) (Protected "Configuring Opayo by Elavon Module for osCommerce 2.3" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading])
Jump to navigation Jump to search

Welcome to the user guide for configuring the Opayo by Elavon module for osCommerce 2.3. This guide will walk you through the process of setting up the module to accept Opayo payments and manage your transactions efficiently.

Ensure you have installed the Opayo Server by Elavon module. Refer to the manuals "Installing Opayo by Elavon module for osCommerce 2.3 via Installer" and "Zip File" for detailed instructions.

If you installed the Opayo by Elavon module via Zip File, click on the "Opayo by Elavon" module and then on the "Install Module" button. If you installed it via Installer, this step is automatically done for you.

1 Install.png


If you haven't obtained your vendor login name yet, click on the "Visit Opayo Website" link.

2 Visit Opayo.png


Fill in the required fields and submit your request.

3 Request butt.png


Upon successful submission, wait for a call from an Elavon payment specialist to confirm your request and create your account. You'll receive an email containing your vendor login name.

4 Success letter A.png


Once you have your vendor login name, click on the "Edit" button.

5 Edit butt.png


Configure the Opayo by Elavon module settings:

  • Accept Opayo PI payments.
  • Fill in the vendor login name to connect to the gateway with.
  • Fill in the Opayo API key and password.
  • Select the processing method to use for each transaction: Authenticate - checks a credit card; Deferred - blocks a small amount of money on a credit card; Payment - processes the whole amount. Depending on the transaction method the corresponding order status is set. In turn, when the order status is switched to the required one and if only the small amount of money was previously blocked, the system will process the whole payment.
  • Perform transactions on the either production or testing server.
  • If a payment zone is selected, it enables this payment method for this zone only.
  • Set the status of orders made with this payment module to this value.
  • Skip 3D secure verification when paid by token on orders below a certain amount.
  • Sort order of display will show this payment method - lowest is displayed first.
6 Settings A.png


To generate the Opayo payment integration API Key and password, follow these steps:

1. Go to MyOpayo in either the TEST or LIVE environment and log in using the Administration log-in details.

7 Sign in.png


2. Navigate to the Password details section of the Administrator tab.

3. Select the option to 'Create API credentials' and confirm. You just have to select the tick-box labelled 'I understand that this will create new credentials and may break any existing Opayo API implementations.' and click on the 'Create API credentials' button.

8 API.png

Once you have opted to create your new credentials you will be presented with the following information:

  • Environment: This specifies the environment for which the credentials apply - test or live.
  • Vendor Name: The vendor name for the account
  • Integration Key: The value for the Integration key – username
  • Integration Password: The value for the Integration password
9 Create new cred.png


If you choose to create new credentials, any previously created credentials will immediately become invalid.

Therefore, if you have already integrated with the REST API, you will not be able to authenticate your calls until you replace your expired credentials with newly generated ones.

Please store these credentials safely. If you lose them, you will need to generate a new set of credentials using the same process.


By following these steps, you can seamlessly integrate Opayo by Elavon module into your osCommerce 2.3 platform and start accepting payments efficiently.

Watch the instructional video on configuring Opayo by Elavon module here