Step 1: Register an account
Register a payever account here: https://commerceos.payever.org/entry/registration/business
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.
If you are using the Checkout app for the first time: simply follow the instructions of our on-boarding assistant and select the desired payment method from the list by clicking on install.
If you have already used the Checkout app: You can find the payment methods in the Payment Options tab at the top of the screen. Click on + Add and select the desired payment method from the list that now appears and click on install.
Once you click Install 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 firstname.lastname@example.org).
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 Magento from the list that now appears and click on Install.
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
Note: Since support for Magento 1 will be discontinued in 2020, there will be no new versions and installation will only be possible by manual upload from August 2020, as the Extension Store for Magento 1 will be closed. Please download the latest version of the plugin from the payever platform and upload the zip file to your Magento shop.
Search for the payever plugin in the Magento Marketplace and install it in your shop. Note that there are two different plugins, one for Magento 1 and the other for Magento 2.
Step 5: Configurations
Log into your Magento backend and open the payever plugin settings (click on System in the navigation bar at the top, then click on Configuration and click on payever which you should find on the the left side of the screen).
Click on payever here to see configuration options.
Now make the following changes to your settings:
- Mode: Please activate the Live mode (unless you want to carry out some test transactions first, in this case please select sandbox - more information on testing can be found at the end of this article).
- Client ID, Client Secret and Business UUID: Please enter the API keys that you generated in your payever account (see Step 3) in the corresponding fields (unless you are in sandbox mode).
- Logging level: Here we recommend the setting Info. You don't usually need the other two options unless you experience technical difficulties later on - our support team may ask you to activate debug mode so that they can better analyze the causes of the problem.
- Display payment icon: Here you can specify whether an icon/logo should be displayed next to the payment method (depending on the payment method).
- Display payment description: Here you can specify whether a description text should be shown under the payment method. If you decide to do this, please make sure to enter a suitable text for the specific payment option.
- Mode Integration: Here we recommend the Iframe setting. If you choose Iframe here the payever checkout will be loaded in an area (Iframe) within your website, and your customer will not need to leave your shop to complete the payment. Otherwise, the customer will be redirected to a new window with a payever URL. Please note: If you use a so-called "One-Step Checkout" you may only be able to use the redirect mode.
- Locale: Here you either select the language of your shop or the Default setting - this means that payever automatically selects the language that is set in this customer's browser.
Save the settings (click on Save Config on the right) then synchronize the payment methods in the Payment App section by clicking on the button Synchronize.
After synchronization, check whether the payment options activated in your Magento backend are the same as those that are activated in your payever account, and that are the payment options you wish to offer to your customers. By clicking on the arrow next to the payment methods, you can also change the individual settings for each payment option (such as description, title and min/max order totals).
Before leaving these settings, make sure to save any changes by clicking on Save config.
Would you like to test the plugin and the payment options before you go live? No problem - you can do so in staging/sandbox mode, since in this mode none of the transactions will result in an actual payment. To activate staging/sandbox mode, set mode to Sandbox in the plugin settings and click on Restore API keys to have the test credentials show up automatically. Alternatively, manually fill in the test credentials (Business UUID, Client secret, Client ID) provided here: https://docs.payever.org/resources/de/test-credentials
In the sandbox mode you are not connected to your own payever account, but to our general test account - which is why you can now see all available payment methods here, 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 and instead enter your own live credentials from your own payever account (see step 3), save and then synchronize (otherwise you will receive an error message when synchronizing). You cannot use your live data in the sandbox mode and vice versa.
- Please also note that any changes made to your settings (plug-in settings, names and description-texts for the payment methods, etc.) are 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 and you are satisfied with the test-results 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 and synchronized.