Opencart

Step 1: Register an account

Create your free payever account here, or login in case you already have one.  

Step 2: Configure payment options

In order to configure your payment options, first open the Checkout app. To do this, either click on the Checkout symbol under Business Apps or click on the Manage or Open button on the Checkout section.  

You can find the payment methods tab in the navigation bar on the left. 

Then click on + Add.

Now a list of different payment methods appears, from which you can select as needed. To do this, click on install.

Once you have installed the payment channel, click on Open and a new page will open, the structure of which will vary depending on the payment method chosen.

With the payment methods credit card, direct debit, Sofortüberweisung and Paypal just click the Connect button and you will be forwarded to the respective payment provider. There you connect  your existing account or create a new one. 

For the payment methods Installments, invoice, Factoring and Direct Bank Transfer you have to enter the access data that you have received from Santander and then click on Connect (if you have not been in touch with Santander before, please contact support@payever.de). 

Regardless of the payment method, please make sure that you always enter your access data in the Default tab.

After you have connected the payment methods, you can make changes to the settings of the specific payment method. Please refer to our documentation for the specific payment method for more information, which you can find here. 

Step 3: Configure channels

Select the Channels tab in the Checkout App.

Click + Add.

Select Opencart Shop from the list that now appears and click on Install.

Now you need to click Open so that you can generate the API keys in the next step.

Select API keys and click on + Add. Enter a name of your choice and click on Generate. Afterwards, click on the plus icon (+) and you see the credentials that you have to insert into the shop system that you use for your online business (i.e., Client ID, Client Secret, Business UUID). Please copy these to your clipboard.

Step 4: Install plugin

Log into your Opencart backend.

Step 5: Configure plugin settings

Fill in the API keys that you generated in your payever account (see Step 3) and set the Environment to Live (unless you want to test first - in that case please refer to the "section on testing"). 

If you set integration mode to iframe our payment options will be shown in an iframe within your page (provided the specific payment option supports this - note that some payment options will always open on full screen because the provider of this payment option won't support any iframe-type integration). If you set it to redirect to payever, the customer will always see our payment options on full screen (regardless of whether the requested payment option generally supports iframe or not).

Confirm your configurations by clicking on Save button.

Step 6: Configure payment methods

Click on Extensions  > Extensions > Payments and edit payever.

Pick Payment Options in order to see and manage your payment options. 

Upon doing so, you will usually first see the Opencart payment options. Here you can synchronise your payment options from your payever business account. After synchronization you can activate or deactivate our payment options by changing payments status to Enabled/Disabled. If you change something do not forget to save your changes by clicking save button on the top right corner of the screen.

Sandbox Mode: Testing the plugin

Would you like to test the plugin and the payment options before you go live? No problem - there is the so-called sandbox mode, in which transactions can be carried out without actual payment processing. To activate sandbox mode, change the enviroment to sandbox in the settings of the payever plugin and automatically apply our test data by clicking on Set up sandbox API Keys. Alternatively you may fill in the test credentials (Business UUID, Client Secret, Client ID) provided here: https://docs.payever.org/resources/de/test-credentials

Once you have changed the credentials and mode, click save to make your changes effective. You are now in Sandbox mode!

Note that in the sandbox mode you are not connected to your own payever account, but to our general test account - which is why you will see all available payment methods in Opencart while you are in Sandbox Mode, not just those that you have activated in your live payever account. 

To test the various payment statuses in the sandbox mode, please use the relevant stub data which you can find here.

Now you can test the plugin without triggering a real transaction. We kindly ask you to test only in the sandbox mode, since test transactions in Live mode, even if they are subsequently canceled, can have undesirable consequences (for example, if you test too often with your credit card it may be reported and blocked or if you submit multiple installment loan applications in your name it can worsen your credit score, etc.). 

When you're done testing and want to go live:

• Please do not forget to remove the test data from you settings - enter your own live credentials from your payever account (see step 3) when you switch to Live Mode and remember to click save afterwards.  You cannot use your live data in the sandbox mode and vice versa. 
• Please also note that any changes made to your payment option settings are usually lost when switching between live and sandbox mode (regardless of the direction). With each synchronization process you reset these settings automatically - so if you have configured everything in sandbox mode, are satisfied and want to go live, please remember what you configured so that you can reapply these settings again after you have switched to live mode. 

After the integration: how to process payments with payever

In general, our plugins are designed so that all actions available in the payever account can also be initiated from your Opencart backend. As a rule, you do not need to log into your payever account to find out about the status of a payment or to cancel a payment, for example.

Status  - The status Paid means that the payment was successful and complete - in this case you can safely ship the goods to your customer. Rejected transactions are marked as "Failed/Declined" in the payever account and will be displayed as Failed in your Opencart shop backend. 

Capture / Shipping Goods -  Please note that most of our payment options  require you to report the order as shipped in order to capture the payment. You do not have to do this manually in your payever account though, it is enough to set the status of the affected order to Sent in your Opencart backend after the goods have been shipped. You can do so by opening the order in your Opencart shop backend (Sales > Orders > select the order). Select payever tab in History section and here press Full Capture. Additionally here user can perform partial captures.

Cancellations and Refunds - To cancel a transaction, it is enough to press Full Cancel button . This holds true for all our payment options that have an automated cancel functionality - some, like instant payment for example, do not this functionality and require further steps to be taken for the customer to receive his money back).