Before you begin
Make sure you have the following in place before using the API:- A published customer journey: A business user must first design and publish the journey in the GBG GO platform. If you’re unsure, check with your team to confirm the journey is ready.
- API access and credentials: You need an API Client ID, Client Secret, Username, and Password. These are provided by your GBG account manager. See the next step, Authenticate, to learn more.
- Understanding of your journey’s tasks: Customer journeys may include document upload, ID checks, or biometric validation. Confirm which steps apply to your specific journey before integrating.
If you’re a business user, work with your developer or technical team to set
up the API integration once the journey is published.
Execution flow
A complete customer journey execution consists of six main steps:-
Authenticate
Get an access token to authorize API requests. -
Start a journey
Trigger a journey instance using the published journey’s resource ID. -
Retrieve tasks
Fetch assigned tasks that need to be completed in the journey. -
Manage schemas
Retrieve schemas to understand the structure of required data for each task. -
Submit task data
Submit data to complete the journey’s tasks. -
Fetch journey state
Check the journey’s current progress or completion status.
If an API request fails, troubleshoot using the Handle errors
guide.