Security & Authentication
Get authorized and secure access to SingleView Open Banking services
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
:
- Log in to your account at https://console.singleview.com.sa
- Go to App Settings
- Click on Create new Client Secret button
- Verify with an OTP received on your registered mobile number
- 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
Updated 8 months ago