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?