Wix combines website creation, e-commerce features, and business tools into a single platform and is used by businesses worldwide. With the payever integration, merchants can expand their payment processes directly within Wix and offer their customers a wider range of payment options at checkout.
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
After having registered on payever and having installed the desired payment options select the Channels tab in the Checkout App.
Click + Add.
Select WIX 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
The payever integration in Wix is not installed like a regular app from the Wix Marketplace. Instead, it is added to your Wix site as a custom payment provider setup. This means the integration must first be configured within your site before it can be connected and used at checkout. To begin the setup, log in to your Wix Studio account and click Edit Site in the upper right corner. Make sure that Developer Mode is enabled in Wix.
Next, click on the Developer Tools icon on the left-hand side, as shown in the screenshot below.
Under Public & Backend, click the + icon beside Service Plugins and choose Payment.
Once you complete the previous steps, Wix automatically creates a payment-provider folder in the Service Plugins section of the Code sidebar. Inside this folder, you will find another folder named after your plugin. This folder contains two files: -config.js and .js.
Name the plugin folder payever-<selected-payment>, replacing <selected-payment> with the payment method you want to integrate. Please make sure to use the correct spelling and pay close attention to uppercase and lowercase letters. You can check the exact naming of the individual payment methods in the GitHub repository here: GitHub repository.
In this example, the payment method is HSBC. Once the folder has been created, copy the contents of /payment-provider/<payment>.config.js and /payment-provider/<payment>.js from the GitHub repository into the corresponding files in Wix Studio.
In the Backend section, click the + icon and select Add Web Module. Then name the new file payever.api.js. After creating the file, copy the contents of payever.api.js into it.
Again in the Backend section, click the + icon and select Add .js File. Then copy the contents of http-functions.js into the newly created file.
Now you need to publish your changes by clicking Publish in the upper right corner
Step 5: Connect to payever
Once you have installed our plugin, open your Wix Dashboard, then navigate to Settings and select Accept Payments.
Then enable your selected payment method and click Connect.
The following settings can now be configured:
Environment: Please deactivate sandbox mode unless you want to carry out test transactions first. If you would like to test the integration before going live, select Live. More information about testing can be found at the end of this article.
Client ID, Client Secret, and Business UUID: Please enter the credentials you generated earlier in your payever account. If you are using sandbox mode, please use the corresponding sandbox credentials.
Redirect directly to PSP: This option determines whether customers are redirected straight to the payment service provider’s payment page during checkout in order to complete the payment.
Site URL: Please enter your full Wix site URL.
Once you have entered all required information, click Connect.
The integration is now complete.
Testing the Plugin: Sandbox Mode
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 none of the transactions you do in this mode will result in an actual payment. We kindly ask you to not test outside of the Sandbox Mode, since testing payments in live mode can have unintended consequences - even if your cancel the transaction right away after you have submitted it (If you test too often with your own credit card, it may be blocked, and if for instance you submit too many installment requests via Santander with your name, this may negatively affect your credit score).
To activate staging/sandbox mode, set Environment to Sandbox in the payever plugin configurations and fill in the test credentials (Business UUID, Client Secret, Client ID). To make sure your test transactions get accepted, please use stub data.
Once you have finished testing and switched to live (Environment = live), please don't forget to fill in your own live credentials (Business UUID, Client Secret, Client ID) then save and synchronize (otherwise you will get an error message).
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 payever account, 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 settings made (plug-in settings, names and texts of 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, are satisfied and therefore want to go live, please remember the configuration you made and repeat these settings again in live Mode. Once configured again, please remember to synchronize.
After integration: information on processing payments
In general, our plugins are designed so that all actions available in the payever account can also be initiated from your WIX backend. As a rule, you do not need to log into your payever account to find out the status of a payment or to cancel a payment, for example!
Status Reports - the payment status in Process usually only occurs with installment loans and means that the payment is not yet complete (customer still has to go through an identification process and / or submit required documents). If you see this status, please wait and do not ship the goods to your customer yet. The Payment Accepted status means that the payment was successful and complete - in this case you are free to ship the goods to your customer. The status Canceled means that the payment failed, was rejected or was canceled by you (again, do not send any goods to your customer with this status).
Capture / Shipping Goods - Please note that with some of our payment methods (e.g. Invoice and Installment loans, possibly also PayPal and Credit Card, if you have disabled automatic capture for this payment option in the settings), you have to report the shipping of goods. However, you do not have to do this manually; it is sufficient if you set the status of the order concerned after the goods have been shipped in Shopware to Completed paid.
Cancellations and Refunds - If you would like to partially or fully reimburse a transaction, please open the order details. For a cancellation choose Cancel / Credit, for a partial return or partial cancellation please choose Partial refund and enter the amount to be reimbursed.
Please note, however, that not all of our payment methods have an automatic cancellation function: Installment loans can only be canceled via payever / WIX before the goods are shipped to the customer. Direct bank Transfers and Direct Debits can only be reimbursed from your bank account via a transfer to the customer.
Any questions or problems?
Our support team is there to help you free of charge from Monday to Friday between 8 a.m. and 7 p.m. at support@payever.de.
Please let us know in your message which shop system and plugin version you are using, which shop (URL and/or email address which you are registered with us) your request concerns, and which error message / problem you are dealing with - so we can process your request as fast as possible.