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 xt:Commerce 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: download the plugin
Log into your xt: Commerce account and download our free plugin. You can either do this via your xt: Commerce plugin store (recommended) or you can download the plugin from your payever account and upload it manually.
Step 5: configure plugin
Log into your xt:Commerce backend and open the payever plugin settings by clicking on Einstelling (Settings) in the navigation bar at the left, on Zahlungsweisen (Payment Options), look for payever and click on the edit icon.
Fill in the API keys that you generated in your payever account (see Step 3) in the corresponding fields (Business UUID, Client Secret, Client ID) and save these settings. Please note that you can also activate and change the individual settings for each payment option. Before leaving these settings make sure to save any changes.
For the field New Order Status, we suggest to keep the default setting (16 = Open).
For Modus, please select live mode (1 = Live).
The setting Zu payever weiterleiten determines whether the payever checkout should be displayed within an iframe on your website or whether the customer should be forwarded to a separate payever URL to complete the payment. We recommend the Iframe setting here, since from the user's point of view it is more convenient not to have to leave the shop in order to complete the payment.
Testing the plugin: sandbox mode
Would you like to test the plugin first? Please activate the sandbox mode (sandbox = yes) and enter our test data in the following fields Business UUID, Client Secret and Client ID, which you can find here. In sandbox mode you are not connected to your own live payever account, but rather to our general test account - that's why you now see all available payment methods here, not just those that you have activated in your own payever account (please note that you will not see test transactions in your payever account). Also note that the test account only works on weekdays from 8 a.m. to 10 p.m. - hence, on weekends, late late afternoons and early mornings you cannot make transactions in sandbox mode!
To have a payment confirmed in test 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 sandbox mode, as test transactions in Live mode, even if you subsequently cancel them immediately, 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, this may 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 data from your live 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 sandbox mode, nor can you use our test data in live!
- Please also note that any changes made to your settings (e.g. 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 change you reset these settings - so if you have configured everything in sandbox mode, and you are satisfied with the test-results and therefore want to go live - please remember what you need to reconfigure these settings again after switching to live Mode and synchronizing.
Any further questions or problems?
You can reach our support from Monday to Friday between 8 a.m. and 7 p.m. at email@example.com
Please let us know in your message which shop system and plugin version you are using, which shop (URL and / or email address with which you are registered with us) your request is concerned and which error message / issue you are dealing with - so that we can process your request as fast as possible!