Configuration properties
Backbase sets these properties when it deploys the Jumio Connector.Values to obtain from the vendor
Obtain the following values from Jumio and send them to your Backbase support team. The following table lists the region-specific Jumio API base URLs.Connector settings
The following table lists the other Jumio Connector properties.Supported operations
The Jumio Connector supports the following operations. For the full contract, see the API playground.User creation and workflow initiation
- Create or update a Jumio account and start the relevant workflow
- Unified API:
POST /applicant-workflows - Include
personName,userData.identification,userData.templateId, anduserData.customerRelationship. The connector mapsuserData.identificationto the JumiocustomerInternalReference. - Use
userData.customerRelationshipto route the journey:falsefor an NTB journey: create a Jumio account and start full identity verification. Don’t senduserData.applicantId.truefor an existing-to-bank (ETB) journey: update a Jumio account for biometric reauthentication. IncludeuserData.applicantId.
- Map a Banking OS
templateIdto the Jumio workflow key with the optionaljumio.template.key.<templateId>configuration property. When you don’t set that property, the connector sendstemplateIdas the workflow key. - The response includes
clientLaunchUrlfor the Jumio browser experience, plussessionId,applicantId, andsdkToken.
Required request fields
The following table lists the fields that the connector requires onPOST /applicant-workflows requests. If a value is missing or inconsistent, the connector returns error GC025 with HTTP status 400.
Workflow results (pull)
- Get the IDV process outcome and the decision metadata for the workflow
- Unified API:
POST /workflow-result - For Jumio, provide
sessionId(Jumio workflow execution ID) andapplicantId(Jumio account ID). Jumio doesn’t usesdkTokenon this call. - The response uses the Unified API
workflowResultsschema and includes Jumio-native capability detail undervendorSpecificFields.jumio. Sync Hub also publishes a separate identity verification event. Thedataobject of that event reuses the same mapped result shape.
Status and decision mapping
Jumioworkflow.status and decision.type values map to Banking OS status and decision.value as follows:
The response includes Jumio capability payloads under
vendorSpecificFields.jumio, for example extraction, classification, similarity, liveness, usability, authentication, and ekycCheck. The raw Jumio retrieval response is available as rawVendorResponse.
Events
Synchronous operations (create applicant workflow, get workflow result) return their result in the API response. Jumio raises identity verification results asynchronously. When Jumio sends an inbound callback, the inbound connector validates the payload. When the callback status isPROCESSED, the connector retrieves the workflow result from Jumio, maps it with the same rules as POST /workflow-result, and publishes an identity verification event to Sync Hub for downstream consumers.
The following table maps the Jumio callback trigger to the Sync Hub topic, CloudEvent type, and connector action:
The connector acknowledges non-terminal callback statuses without retrieval or Sync Hub publication.
The Sync Hub
data object follows the identity verification event schema. It includes workflow status, applicant identifiers, decision metadata, and Jumio-specific fields under vendorSpecificFields.jumio where applicable.
Consumers receive identity verification events by subscribing to the Sync Hub topic configured for your environment. For setup, see Sync Hub overview and Get started with Jumio.
Error mapping
For the full list of Banking OS error codes and their descriptions, see Error codes. Jumio request validation uses the error codeGC025 with HTTP status 400. The connector returns GC025 when userData.customerRelationship, userData.identification, or userData.templateId is missing. It also returns GC025 when userData.applicantId is present for an NTB journey (customerRelationship is false). It returns GC025 when userData.applicantId is missing for an ETB journey (customerRelationship is true).
The following table maps Jumio HTTP error responses to Banking OS error codes. The connector maps any other Jumio HTTP error to GC025.
For these mapped Jumio errors, the HTTP status that the connector returns comes from the Banking OS error code catalog.
Dependencies
The Jumio Connector depends on the following systems:- The Jumio Accounts API, to create and update accounts
- The Jumio Retrieval API, to retrieve workflow results
- Sync Hub, to publish identity verification events on the
identity-verificationtopic