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 Oxid 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
Search for the payever plugin in the OXID exchange marketplace and install it to your OXID shop.
Step 5: Configurations
Log into your OXID backend and activate the payever plugin by clicking on Extensions in the navigation bar at the left, then on Modules, then on payever and eventually on Activate at the right side of the screen.
After activation, open the payever plugin settings by clicking on payever in the navigation bar at the left. 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), set mode to 'live' and save these settings (by clicking on Save). Next, synchronize the payment options with your account by clicking on Synchronize Settings.
After synchronization, check whether the payment options that are activated in your OXID backend are the same that are activated in your payever account and that you want to offer to your customers. To do so, go to Shop Settings in the navigation bar at the left and choose Payment Methods. In this menu, you can activate the various payment options and also change the individual settings for each payment option.
TESTING MODE - SANDBOX
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 will then result in an actual payment. To activate staging/sandbox mode, set mode to Sandbox in the plugin settings and click on Set up sandbox API keys. Alternatively, fill in our test credentials (Business UUID, Client Secret, Client ID) manually, as provided here: https://docs.payever.org/resources/de/test-credentials
Note that you will neither be able to test with your actual credentials nor will you be able to live with the test credentials, so don't forget to manually fill in your actual credentials (Business UUID, Client Secret, Client ID) again, once you are done with testing (otherwise you will get an error message).
Attention: Are you offering the payment option "Santander Invoice"?
If you are offering the payment option Santander Invoice, please add the correct bank account details of Santander to the invoice your shop system automatically sends to customers. By doing so, you can make sure that the customer does not accidentally transfer money to you, when he should be sending it to Santander instead. The customer will also receive a separate email with the bank account details of Santander via email, yet many customers think - especially in the case of Santander Invoice - that they need to act upon your invoice. This is why you should add the bank details of Santander to the invoice of customers who paid via Santander invoice by following these steps:
Go to CUSTOMER INFO > CMS PAGES to look for your invoice template (or other templates with the variable $order). In any template with the $order variable, you can insert the bank details by pasting the following code:
[{if $order->oxorder__panid->value}]
Sie haben bei dieser Bestellung eine Zahlungsart der Santander gewählt. In Kürze erhalten Sie von der Santander eine Email mit allen Informationen zu den weiteren Schritten und Zahlungsfristen. Bitte achten Sie darauf, das Geld nicht an uns, sondern an das unten angegebene Konto der Santander zu überweisen und dabei den folgenden Verwendungszweck anzugeben:<br>
Empfänger: Santander Consumer Bank AG<br>
IBAN: DE89 3101 0833 8810 0761 20<br>
BIC: SCFBDE33XXX<br>
Betrag: [{ $order->oxorder__oxtotalordersum->value|number_format:2:",":"" }] [{ $order->oxorder__oxcurrency->value }] <br>
Verwendungszweck: [{ $order->oxorder__panid->value }]<br>
[{/if}]
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 Shopware 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 send the goods yet. The status OK means that the payment was successful and complete - in this case you can ship the goods to your customer. The status declinedmeans that the payment has failed, was rejected or was canceled by you (for this status, please do not ship any goods to your customer).
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. To do this, please open Administers Orders > Orders and click on the transaction that is affected and then click "Ship Now".
Cancellations - If you want to refund a transaction, please open the order details (Administer Orders > Orders) and click on the icon below the trash can (Cancel entry). Just confirm with OK and you should have the cancellation listed in the bottom section.
Any further questions or problems?
You can reach our support 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 with which you are registered with us) your request is concerned and which error message / issue you are dealing with - so we can process your request as fast as possible!