Viva Merchant configuration
The followings steps are required in order to integrate Viva with SensePass:
Login to Viva merchant portal with your merchant account credentials.
Webhook setup
Click on “Settings” menu ==> “API Access”. Switch to “Webhook” tab and click on “Create Webhook”.

On the new popup window fill the fields as below:
URL: https://api.sandbox.sensepass.com/api/transactions/viva/webhook/merchant/37xxxxx
o Please replace “37xxx” with your Viva merchant ID (can be taken from “General Tab” – Merchant ID).
o Make sure this is the merchant ID you have set in the SensePass Parters Dashboard ==> Payment Method ==> Viva credentials.
o In production, make sure to use the following URL https://api.sensepass.com/api/transactions/viva/webhook/merchant/37xxxxx
Click “Verify”.
Check “Active”.
Choose “Transaction Pos Ecr Session Completed” as the Event type.
Click “Save”.

Apps setup
Click on “Sales” menu ==> “Online Payments” ==> “Websites/Apps” menu and click on “Add Website/App”.

On the new popup window fill the fields as below:
· Code – sensepass
· Source name – Sensepass
· Protocol – Https
· Domain Name - api.sandbox.sensepass.com (In production, make sure to use the following URL: api.sensepass.com)
· Logo – you can upload the merchant logo or keep it as is
· Success URL – api/transactions/viva/callback/success
· Failure URL - api/transactions/viva/callback/failure
· Fill the below fields under “Advanced configuration”:
Order Code – ocode
Transaction ID – tid
Language – lang

Check all below options:
My website is available via a public domain name
A privacy and data security policy exists and is referred to
Terms & Conditions include delivery methods and return/cancellation policy
Customer service contact details are available and easy to find on the website
viva.com logo is displayed on payment screens
Last updated
Was this helpful?