Adyen account in Adyen platform
Before setting up the Adyen microservice in the Wizard make sure that you have created an Adyen account and Adyen device is registered there. If not please follow this article.
Set up Adyen terminal for payments
Make sure that the correct POS Super Wrapper application has been downloaded on your device -> Dowload app
Once app is dowloaded open it on your device.
Login with Erply credentials (client code, username, password)
Click on the cog button (POS Settings) -> Payment Configuration
Click on the Setup Payment gateways
From the ‘Select current integration’ select the Native wrapper iOS/Android
Click on the ‘Open payment settings’
Click on the ‘Adyen’. 'Adyen configurations' popup will apear.
Fill the valid API Key and press Save:
Note: It will be stored in CAFA on Warehouse level. It means that every location should have a separate Adyen API key. Info how to create an Adyen API key you can find in Adyen docs (https://docs.adyen.com/development-resources/api-credentials/)
Once the API key was added successfully, you can proceed to add the terminal. All terminals that users need to utilize must also be added from the Adyen account.
Click on the ‘Add terminal’.
Fill in all the necessary fields (Terminal ID, Terminal Key Identifier, Terminal Key Passphrase, Terminal Key Version, Terminal IP Address). All the mentioned data can be found in the Adyen account.
Select the Region:
- Test
- Europe
- Australia
- USA
Select Connect type:
- Local - This is used to connect to a terminal that shares the same WiFi connection as the iOS device.
- Cloud - This is used to connect to a terminal that has been added in the Adyen Portal, fetching the terminal's IP from the cloud and establishing a connection to it.
- Local, Cloud - This serves as a backup connection. If a local connection is unavailable, it will attempt to connect to the terminal through the cloud.
- Cloud, Local - This also serves as a backup connection. If a cloud connection is unavailable, it will attempt to connect to the terminal through a local connection.
Press the Connect button.
If you see the following popup, please click ‘Allow’:
Device will show you a message “Connection succeeded”.
After the successful terminal setup you are able to perform actions such as Save, Set as Active or Remove terminal by tapping on the corresponding button. If you make a long-press on the Save button then you are able to see the option to ‘disconnect’ theterminal.
When the user has already saved the terminal, it will appear on the Payment Settings screen, where all terminals are listed:
From there, you can tap on the terminal to access multiple actions such as Test Connection, Set as Active, and Remove the terminal.
By swiping from right to left on the list, users will reveal a 'Remove' button, allowing them to remove the terminal from the system. For terminals with printer support, users will additionally see a 'Configure' button:
The ‘Configure’ button allows users:
- to edit terminal IP if it has been changed on the terminal
- to specify the type of receipts they want to print on the terminal after the payment, with options including None, Merchant Only, Customer Only, and Both.
Make sure that the connection status is ‘Active’, if not please set is as Active (should become green):
Set up Adyen terminal as printing device
In the SuperWrapper application navigate to the Settings -> Payment configuration.
From the “Select current integration” select the Native wrapper(iOS/Android).
From the Payment Settings section click on the yellow “Open payment settings” button.
Click on the Adyen.
Make sure that the payment terminal is configured and active. If not please follow instructions here to set up the payment terminal.
Swipe from right to left and click Configure.
Enable the “Print receipt from terminal”.
Press ‘Close’ to close the configuration window.
Close the payment settings window.
Now you need to update the terminal configuration to active receipt printing on the terminal. In order to do this please follow instructions below:
On the terminal press 9 and OK(green button).
On the terminal screen click “Config”. Then click “Update”.
Once the terminal is ready to use you can perform a test.
To test the receipt printing, please navigate to the POS Recent Sales, select the sale and click on the ‘print receipt’ button(printer and paper icon).
How to check additional information on the adyen terminal?
- To see the terminal’s information with the IP address, press 5 and then OK [5->OK].
- To see Payment menu, press 8 and then OK [8->OK].
- To access the terminal’s Administrative menu, press 9 and then OK [9->OK]. Enter PIN code and press OK to continue [code->OK].
- To access network, press 9 and then OK [9->OK]. Select Network and enter PIN code.
Pay with Adyen
Add products into the shopping cart.
Hit Pay.
Select card payment - the payment row is added with Adyen integration:
Click “Confirm” on iPhone or ‘green checkmark’ on iPad to finalize the payment.
Cancel the payment
Removing the payment card during the payment processing
In this case the POS will show the following message in payment window:
“Current payment status: APPROVED 127 Card declined online result”
Here you can decide:
- “Close” to return back to the payment screen.
- “Retry Payment” to send another payment attempt to the terminal.
Cancelling the payment in POS payment window
If you close the payment processing window and payment has been already approved, the POS will return back to the payment window. You may see that sale has been already paid by card:
You can cancel the payment clicking on the ‘red cross’ button below or just close the payment window:
Afterwards the POS will give you a “Closing payment window” popup with message “Payment plan contains handled payments which will be automatically voided”. There you can choose:
- “Cancel” - return to the payment screen
- “OK” - cancel the payment and return funds back to the client card.
In case you will press “OK” button the POS will start voiding the payment and you will see the following screen:
Return with Adyen
Referenced return (return based on receipt)
In order to start the return for sale that was paid by card with Adyen integration, you need to find the sale in the POS using the receipt number. It can be found under the red “Return” button or in Recent Sales.
Once receipt has found select products, apply reason codes if it is required and click Save.
Hit Pay.
In the payment window you will see the initial card payment on the right side and automatically applied return payment on the left side:
In case you would like to refund money to the same card, please click on the ‘green checkmark’.
In case you would like to change the return payment method please click on the automatically applied return payment method
and then green OK button on the left side numpad:
Afterwards apply another return payment method and finalize the return.
Note: If the payment method is not automatically selected and you would like to make a refund to the client card, that document was paid with, click on the original payment method on the right side.
Unreferenced return (return without the receipt)
Add needed products to the POS shopping cart.
Set a negative quantity for products.
Select the return reason if it is required.
Hit Pay.
Select the card payment method.
Finalize the payment by clicking on the ‘green checkmark’.
You will see the “refunding purchase” process in the POS payment window:
Close day with Adyen
The “Sync batch to day openings” in the Payment configuration -> Setup payment gateways -> Adyen:
- if enabled - while closing the day in the POS, day is also closed on the terminal and all the payments are sent to the bank automatically.
- if the setting is disabled, you need to close the day in the POS and terminal separately.