Make sure payment handling is enabled for your solution, so Vipps payments can be handled. Contact Cloud Retail Systems' support if you are in doubt.
Open Financial.
Go to the "Incoming Payment Options" page and create a new incoming payment method with "Payment type" = Vipps E-payment and "Quick access available" enabled.
Make sure payment handling is enabled for your solution, so Vipps payments can be handled. Contact Cloud Retail Systems' support if you are in doubt.
Open Pos.
Go to the "Vipps Agreements" page and click the "+" button. Enter the display name of the new Vipps agreement in the editor and click the "Set API Keys" button. Then enter the API keys (client_id, client_secret, and Ocp-Apim-Subscription-Key).
Then click "Save".
Note: API keys are stored in the database in encrypted form, so they will not be available the next time you edit, and if the user wants to change them - they must be entered again.
On the "Vipps agreements" page with the selected Vipps agreement, click the "Register webhook" button.
Go to the "Vipps Sales Units" page and click the "+" button. Select the current organizational unit in the dialog window that opens.
An edit window then opens, where you define the Vipps sales unit display name and the selected Vipps agreement (e.g. created in a previous step).
The Merchant serial number must also be entered on the Vipps sales unit.
On the "Vipps sales units" page with the selected Vipps sales unit, click the "Merchant callback Qrs" button.
Then click the "Sync with Vipps" button in the popup window to fetch previously created webhooks from Vipps. In this popup it is also possible to create a new Merchant callback QR or convert an existing MobilePay QR to a Merchant callback QR. It is also possible to see the QR image.
Go to the "Agent Instances" page and select one of the agent instances in the grid (e.g. NoAgent). Then click the "View agent profiles" button.
Select one of the agent profiles and click the "Edit" button. In the window that opens, select the Vipps sales unit and one of its Merchant callback QRs.
Save the changes and select the modified agent profile for the current session.
The payment flow will be demonstrated by creating a sale.
Go to the "New sale" page and click the "Start new sale" button.
Add some products to the cart.
Then click the "Vipps" button (the payment option that was created during setup).
The payment screen opens. Uncheck the "Email invoice" checkbox (for convenience) and click "Pay"
The customer identification dialog will open.
There are 2 options: Enter the customer's phone manually, or scan the merchant's callback QR previously assigned to the agent profile, after which the window closes automatically and the payment begins.
Then there are 2 options:
A - Unhappy flow. Before the user approves the payment on their phone, click the "Cancel" button.
The payment will then be cancelled.
B - Happy flow. The customer gets a push notification about the payment on their phone with the information: ""Tenant name": payment for sale "Sale id"". Approve the payment on the customer's phone. The payment will be captured and completed, and if the payment amount is enough to complete the sale - the sale will be completed automatically.
Go to the "Sales" page and click the "View" button on the most recently selected sale. The "View sale" page will open.
Find the Financial section on the "View sale" page and click the "log" icon for the Vipps payment
The Vipps E-Payment event log will be shown
On the "View sale" page, click the "Refund" button.
Click "Select all" in the popup that opens and then "Refund"
The returned items will be placed in the cart.
In the "more" menu, click the item "Refund original sale payment".
In the popup that opens, select the payment to refund and the amount to be refunded, then click "Ok".
The refund payment will be registered.
It is possible to click the "log" icon to show the event log with the refund registration.
Want to know more?
Read more in these related articles:
Getting started with Vipps MobilePay POS
Getting started with Vipps MobilePay POS
Vipps MobilePay setup
Vipps MobilePay setup
Vipps E-Payment
Settings for Vipps E-Payment at the cash register — sales unit id and merchant callback QR, which are filled in as part of Vipps onboarding.
