👉 The Foreground request is used to bring to the ‘Viva.com Terminal’ application to the foreground when desired.
The client app must implement a mechanism to send messages using iOS intents and URI calls and to receive the result in a custom URI callback.
Foreground request originating from the client app to bring ‘Viva.com Terminal’ application to foreground.
Foreground request
For a typical Foreground request, the client app must provide the following information:
Field
Description
Example
scheme
The Viva's custom URL scheme, the host and the version.
'vivapayclient://pay/v1'
merchantKey
The merchant's key
Deprecated: you may pass any value
'SG23323424EXS3'
appId
The client app id
'com.example.myapp'
action
Foreground request
foreground
callback
The URI callback that will handle the result.
'interapp-callback://result'
Response
No response is sent back
Get Support
If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!