Foreground request
An overview of the Foreground request message for iOS.
Overview
👉 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!