Credentials

Client ID

Client ID is a unique client identification value that varies with the client App. It is allotted upon the addition of a new App. This value cannot be deleted or modified.

To know your clientId, go to App Settings > API Client > Credentials

Here, you can view and copy your clientId.

Client Secret

Client Secret clientCode is a secret key to authenticate your application. Keep the value safe and private, as it is a validatory requirement to make API calls.

Setup Client Secret

To set a Client Secret clientCode:

1. Log in to your account at https://console.singleview.com.sa
2. Go to App Settings

3. Click on Create new Client Secret button
4. Verify with an OTP received on your registered mobile number
5. Once you have successfully verified the OTP, your Client Secret is created

🚧

Important Info

In case your Client Secret is compromised or you doubt if it is shared with others, you can always revoke the existing key value and create a new one.

• To revoke a Client Secret, go to App Settings > API Client > Revoke (option available under Credentials section
• To create a new Client Secret clientCode, follow the above process

MTLS Authentication

Mutual Transport Layer Security (mTLS) is a mutual authentication method that verifies the parties at each end of a network connection by using a private key.

The following steps are involved while creating an mTLS protocol:

Step 1 Client shares CSR with SingleView via email to [email protected]

Step 2 SingleView signs the certificate using root CA and shares it back with the Client

Step 3 The Client uses this certificate with their private key during the handshake

Redirect URLs

This section allows the setting up return URLs for your application, which is essential for redirecting users during data authentication and payment authorization.

To access this section, go to App Settings > API Client > Redirect URLs

Add a New Redirect URL

To add a new return URI:

• Click the + Add new Redirect URL button in the "Redirect URLs" section
• Enter your desired return URL in a valid format
• Click on the "Save" option

Note that a new redirect URL gets activated instantly. But sometimes, it may take up to 15 minutes for the unique redirect URL to start working.

Edit or Delete Existing URIs

If you ever need to make changes to or remove an existing URI, it's a simple process:

• To edit a URI, click the pencil icon and make the necessary adjustments
• To delete a URI, click the bin icon next to it