Web Application
Example using React:
import React from 'react';
import ZeroHashSDK, { AppIdentifier } from 'zh-web-sdk';
const App = () => {
const sdk = new ZeroHashSDK({
zeroHashAppsURL: "https://web-sdk.cert.zerohash.com",
userOnboardingJWT: "<JWT_TOKEN_HERE>"
});
sdk.openModal({appIdentifier: AppIdentifier.ONBOARDING})
return <></>;
}
export default App;
Note: There is another way to get a token for the onboarding module. Please refer to Acquire an onboarding access token
Mobile Application (WebView)
To use our SDK on mobile apps, you don't need to install or include zh-web-sdk as a dependency in your project. We use a proxy server that calls the SDK internally to make it work for mobile applications.
Events
We forward events from the UI to the native app using the postMessage API. You can handle these events from the WebView component. Currently, these are the events we have:
| Message | Meaning |
|---|---|
| SDK_MOBILE_READY | The SDK is ready to receive postMessage events (e.g OPEN_MODAL) |
| ONBOARDING_APP_LOADED | The SDK is loadedSDK loaded and is visible to the customer. |
| ONBOARDING_CLOSE_BUTTON_CLICKED | The close (X) button was clicked in the top right corner of the UI. |
| ONBOARDING_PENDING_APPROVAL | KYC submission requires manual review by the Zero Hash compliance team. There is a corresponding participant status webhook to this message. |
| ONBOARDING_COMPLETED | The flow was completed and internal calls were made successfully. Note: “completed” does not equate to “approved” or “success”. The flow can be successfully completed, but the participant status could be “rejected”, for example. |
| ONBOARDING_FAILED | The customer encountered an error that cannot be rectified in their current session. |
Messages
To control the WebView, you can also send messages using the postMessage API after receiving SDK_MOBILE_READY from WebView. Currently, the accepted messages are:
Open Modal
Opens the modal with the JWT provided for identifier provided.
{type: "OPEN_MODAL", payload: {jwt: "<JWT_HERE>", appIdentifier: "onboarding"}}
Close Modal
Closes the modal for identifier provided.
{type: "CLOSE_MODAL", payload:{appIdentifier: "onboarding"}}
For more details on how to use our SDK with WebViews, please refer to Integration with Mobile Apps