OpenCart

You can find our extension here:

Installation guide

Requirements:

• PHP v7.4 or higher
• OpenCart v3.0 or higher
• Your website must have an established HTTPS connection (SSL installed )

To install the ConnectPay extension, visit the Extensions -> Marketplace page inside your OpenCart admin area and then search for ConnectPay at the top „Search extensions“ search box (Image 2.1).

After that, find the ConnectPay extension in the list, click on the extension, find Download in the description, and click the „Install“ button.

Image 2.1

Alternately, you can download extension from OpenCart Marketplace website. Downloaded zip file needs to be uploaded to OpenCart by following Extensions -> Installer and pressing „Upload“button (Image 2.2).

Image 2.2

How to find a module in your e-commerce?

To locate ConnectPay extension follow Extensions -> Extensions, from Extension List dropdown select Payments (Image 3.1)and locate ConnectPay from the list.

Image 3.1

Then, click on „Install“ button (Image 3.2)and after successful installation configuration page can be accessed by pressing „Edit“ button (Image 3.3).

Image 3.2

Image 3.3

How to configure your module?

Once you’ve opened our extension, please enter your credentials, and configure basic features.

Image 4.1

• Enable functionality to use our module in your E-Shop.
• Client ID is provided to you after you sign a contract with us.
• Client secret is provided to you after you sign a contract with us.
• Private key is provided to you after you sign a contract with us, please don’t change the format and upload exactly as you got it from us.
• Brand ID is provided to you after you sign a contract with us.
• Payment methods – payment methods for the customers to pay within the E-Shop. PIS is a payment initiation service, which allows to pay via payment provider (bank);  CARD – payment method by debit/credit card (MasterCard or Visa). If you have a contract only for payment initiation service, before enabling Cards, please contact your account executive for your contract change.
• Update Payment Providers – button for getting/updating payment providers (based on selected country on Payment countries field). It will only work with the correct authentication credentials.

Image 4.2

• Payment providers – payment providers list (based on a selected country from the Payment countries field) with the function to enable/disable payment providers for the E-Shop. It is an optional configuration. If you don’t choose any, then your customer is redirected to our widget and selects providers there. If you choose some options, then the provider list and logos are represented in your E-Shop, and your customer selects providers in your environment. At this moment, the selection is not possible for German providers.
• Payment countries – it can be the main country that is used first, from which providers (banks) are used to accept payments. You can use multiple countries, but one must be selected by default (it represents the first value in our widget / your E-Shop your customers will see). Options list:
  • DE – GermanyFI – FinlandNL – NetherlandsLT – Lithuania
  • All available countries

• Default payment country in widget (only visible when „All available countries“ is selected) – payment country which customer will immediately see when prompted to ConnectPay’s area via „By bank transfer“ payment method.

Notices and requirements:

1. At least one payment method should be selected. Select a method that is mentioned in your contract.
2. If the PIS payment method is selected, then at least one payment provider should be selected.
3. If you work in multiple countries, after changing payment country, make sure to save the form and then update payment providers via the „Update“button.
4. When „DE“or „All available countries“ is selected, instead of payment providers list in the checkout, customer will see payment option – „By bank transfer“, which will allow to freely choose any payment provider.
5. When „DE“is selected, after selecting „By bank transfer“ customers will be redirected to ConnectPay’s area, and there they will be able to search through Germany payment providers and pay via their selected bank.
6. If you work in multiple countries, when „All available countries“is selected, you will need to choose payment country, which the customer will see by default when selecting the „By bank transfer“ payment method.
7. When something is incorrect, you will see an error message at the top of the form.

Image 4.3

Order states

Image 5.1

Configure how ConnectPay will change order status according to payment status in your OpenCart system.

ConnectPay controls 3 different OpenCart order statuses:

• When payment is successful, then the order in your E-Shop is changed to „Processing“.

• When payment is unsuccessful (failed or abandoned), then the order in your E-Shop is changed to „Failed“.

• When payment is not in final state (e. g. waiting for bank’s approval), then order in your E-Shop is changes to „Pending“.

Possible errors

Possible errors list:

• Admin panel:
  • „X-Signature header is missing or invalid“ – wrong private key uploaded.
  • „Invalid credentials“ – Client ID or Client Secret or Brand ID is incorrect.

Logging

If you get an unexpected error, you can check the error in more detail in the Error logs. To do this, you need to visit the System -> Maintenance -> Error Logs (Image 7.1).

Image 7.1

Cron job

When the order is placed via the ConnectPay payment method, payment updates are received via notifications from ConnectPay; these notifications will update the order status according to the payment status set in the Order Status tab. Additionally, an every-hour cron job must be set, which will do two additional checks on payment status and change order status (if notification was not received):

• The first will check the payment status after 4 hours

• The second will check the payment status after 5 hours and then every hour until the final payment status is received.

To run a cron job, a specified Cron URL shown in the ConnectPay Settings tab must be executed hourly (Image 8.1).

Image 8.1

E-Shop side

Description for E-Shop checkout side.

The checkout page with the selected ConnectPay payment method will look something like this:

Image 9.1

Image 9.2

All payment providers selected in the plugin configuration page will be shown here, at the checkout page for customers to choose. Options will differ, based on selected payment methods and payment countries.

DE or All available countries selected as payment country, PIS payment method selected:

Image 9.3

DE or All available countries selected as payment country, PIS and CARD payment methods selected:

Image 9.4

Only CARD payment method selected:

Image 9.5

Currencies

Currently, ConnectPay supports only EUR currency for the Accept Payments service.

If you have any questions on how to configure this module, please contact us at [email protected] If you wish to get a proposal for a contract, please contact [email protected]