OneSpan Identity Verification API Rapid Proof of Concept Reference
  • 05 Nov 2024
  • 4 Minutes to read
  • Dark
    Light

OneSpan Identity Verification API Rapid Proof of Concept Reference

  • Dark
    Light

Article summary

Available APIs

IDV API RPOC workflows

Description

Syntax

Create transaction

Creates and starts the execution of a transaction.

PUT https://gs.onespan.cloud/rpoc-saa/api/transaction/

Get transaction status and metadata

Retrieves the transaction status and metadata.

GET https://gs.onespan.cloud/rpoc-saa/api/transaction/TRANSACTION_ID

Get transaction verification

Retrieves the transaction verification results.

GET https://gs.onespan.cloud/rpoc-saa/api/transaction/TRANSACTION_ID/verification

Apply lender signature

Applies the lender signature for a transaction.

PUT https://gs.onespan.cloud/rpoc-saa/api/transaction/TRANSACTION_ID/event

Get evidence

Retrieves the complete evidence audit trail for a transaction.

GET https://gs.onespan.cloud/rpoc-saa/api/transaction/TRANSACTION_ID/document/AuditTrailDocument/pdf

Get document

Retrieves metadata and content of the document which is being processed in the transaction.

GET https://gs.onespan.cloud/rpoc-saa/api/transaction/TRANSACTION_ID/document/DOCUMENT_ID/pdf

Cancel transaction

Cancels an ongoing transaction.

PUT https://gs.onespan.cloud/rpoc-saa/api/transaction/TRANSACTION_ID/event

Mark transaction for erasure

Marks one or more complete or incomplete transactions for deletion.

POST https://gs.onespan.cloud/rpoc-saa/api/transaction/mark-for-erasure

Unmark transaction for erasure

Reverts the marking of a transaction for erasure.

POST https://gs.onespan.cloud/rpoc-saa/api/transaction/unmark-for-erasure

Workflow details

The following workflows are available:

  • Workflow ID: 00000001-0001-0001-0002-310000000007

    North American Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVNA001-M (see IDV API RPOC workflow details (1))

  • Workflow ID: 00000001-0001-0002-0002-310000000007

    North American Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVNA001-V (see IDV API RPOC workflow details (1))

  • Workflow ID: 00000001-0001-0001-0002-320000000007

    North American Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVNA002-M (see IDV API RPOC workflow details (2))

  • Workflow ID: 00000001-0001-0002-0002-320000000007

    North American Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVNA002-V (see IDV API RPOC workflow details (2))

  • Workflow ID: 00000001-0001-0001-0002-410000000007

    Global Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVGL001-M (see IDV API RPOC workflow details (3))

  • Workflow ID: 00000001-0001-0002-0002-410000000007

    Global Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVGL001-V (see IDV API RPOC workflow details (3))

  • Workflow ID: 00000001-0001-0002-0002-420000000007

    Global Identity Verification (User Testing Rule Set), with multi-device handoff features, IDVGL002-V (see IDV API RPOC workflow details (4))

  • Workflow ID: 00000001-0000-0002-0002-420000000007

    Global Document Verification (User Testing Rule Set), with multi-device handoff features, IDVGL002-V (see IDV API RPOC workflow details (4))

  • Workflow ID: 00000001-0001-0001-0001-200000000007

    Recommended. North American Drivers License (Global Passport) Verification (Demo Friendly Rule Set), with multi-device handoff features (see IDV API RPOC workflow details (5))

  • Workflow ID: 00000000-0001-0001-0001-200000000007

    North American Drivers License (Global Passport) Verification (Demo Friendly Rule Set) – Mobile Only (see IDV API RPOC workflow details (5))

  • Workflow ID: 00000001-0001-0002-0001-200000000007

    Recommended. Europe, Central and South American Drivers License and ID Cards (Global Passport) Verification (Demo Friendly Rule Set), with multi-device handoff features (see IDV API RPOC workflow details (6))

  • Workflow ID: 00000000-0001-0002-0001-200000000007

    Europe, Central and South American Drivers License and ID Cards (Global Passport) Verification (Demo Friendly Rule Set) – Mobile Only (see IDV API RPOC workflow details (6))

  • Workflow ID: 00000001-0001-0002-0002-200000000007

    Recommended. Europe, Central and South American Drivers License and ID Cards (Global Passport) Verification (User Testing Rule Set), with multi-device handoff features (see IDV API RPOC workflow details (7))

  • Workflow ID: 00000000-0001-0002-0002-200000000007

    Europe, Central and South American Drivers License and ID Cards (Global Passport) Verification (User Testing Rule Set) – Mobile Only (see IDV API RPOC workflow details (7))

The following tables list the possible verifications with details for each workflow:

  • true/false determines if the specific verification is enabled.

  • execute_only, affects_verification_status determines what happens if the specific verification is enabled.

  • X% specifies the threshold the specific verification must meet to be considered valid.

IDV API RPOC workflow details (1)

00000001-0001-0001-0002-310000000007

00000001-0001-0002-0002-310000000007

Mobile handoff support

Multi device

Multi device

Services:

Doc ID/FaceID

✓/✓

✓/✓

Matcher level

UAT

UAT

Country ID list

UAT1

UAT2

Name verification

true, affects_verification_status

true, affects_verification_status

Document number

true, execute_only

true, execute_only

Date of birth

true, affects_verification_status

true, affects_verification_status

Date of expiry

true, affects_verification_status

true, affects_verification_status

Document supported

Address match

Document authenticated

true, affects_verification_status

true, affects_verification_status

Face similarity

true, affects_verification_status

Person alive

true, affects_verification_status

Selfie authenticity

true, affects_verification_status

Threshold: Similarity

70%

70%

Threshold: Selfie authenticity

80%

Threshold: Document authenticity

65%

Threshold: Liveness check

70%

90%

Threshold: Name match

70%

IDV API RPOC workflow details (2)

00000001-0001-0001-0002-320000000007

00000001-0001-0002-0002-320000000007

Mobile handoff support

Multi device

Multi device

Services:

Doc ID/FaceID

✓/✓

✓/✓

Matcher level

UAT

UAT

Country ID list

UAT1

UAT2

Name verification

false, affects_verification_status

false, affects_verification_status

Document number

false, execute_only

false, execute_only

Date of birth

false, affects_verification_status

false, affects_verification_status

Date of expiry

true, affects_verification_status

true, affects_verification_status

Document supported

Address match

Document authenticated

true, affects_verification_status

true, affects_verification_status

Face similarity

true, affects_verification_status

Person alive

true, affects_verification_status

Selfie authenticity

true, affects_verification_status

Threshold: Similarity

70%

70%

Threshold: Selfie authenticity

80%

Threshold: Document authenticity

65%

Threshold: Liveness check

70%

90%

Threshold: Name match

70%

IDV API RPOC workflow details (3)

00000001-0001-0001-0002-410000000007

00000001-0001-0002-0002-410000000007

Mobile handoff support

Multi device

Multi device

Services:

Doc ID/FaceID

✓/✓

✓/✓

Matcher level

UAT

UAT

Country ID list

UAT1

UAT2

Name verification

true, affects_verification_status

true, affects_verification_status

Document number

false, execute_only

false, execute_only

Date of birth

true, affects_verification_status

true, affects_verification_status

Date of expiry

true, affects_verification_status

true, affects_verification_status

Document supported

Address match

Document authenticated

true, affects_verification_status

true, affects_verification_status

Face similarity

true, affects_verification_status

Person alive

true, affects_verification_status

Selfie authenticity

true, affects_verification_status

Threshold: Similarity

70%

70%

Threshold: Selfie authenticity

80%

Threshold: Document authenticity

65%

Threshold: Liveness check

70%

90%

Threshold: Name match

70%

IDV API RPOC workflow details (4)

00000001-0001-0002-0002-420000000007

00000001-0000-0002-0002-420000000007

Mobile handoff support

Multi device

Multi device

Services:

Doc ID/FaceID

✓/✓

✓/–

Matcher level

UAT

UAT

Country ID list

UAT2

UAT2

Name verification

true, affects_verification_status

true, affects_verification_status

Document number

false, execute_only

false, execute_only

Date of birth

true, affects_verification_status

true, affects_verification_status

Date of expiry

true, affects_verification_status

true, affects_verification_status

Document supported

Address match

Document authenticated

true, affects_verification_status

true, affects_verification_status

Face similarity

true, affects_verification_status

Person alive

true, affects_verification_status

Selfie authenticity

true, affects_verification_status

Threshold: Similarity

70%

70%

Threshold: Selfie authenticity

80%

80%

Threshold: Document authenticity

65%

65%

Threshold: Liveness check

90%

90%

Threshold: Name match

IDV API RPOC workflow details (5)

00000001-0001-0001-0001-200000000007

00000000-0001-0001-0001-200000000007

Mobile handoff support

Multi device

Single device

Services:

Doc ID/FaceID

✓/✓

✓/✓

Matcher level

Developer

Developer

Country ID list

DEV1

DEV1

Name verification

false, execute_only

false, execute_only

Document number

false, execute_only

false, execute_only

Date of birth

false, execute_only

false, execute_only

Date of expiry

true, execute_only

true, execute_only

Document supported

true, execute_only

true, execute_only

Address match

false, execute_only

false, execute_only

Document authenticated

true, affects_verification_status

true, affects_verification_status

Face similarity

Person alive

Selfie authenticity

Threshold: Similarity

10%

10%

Threshold: Selfie authenticity

Threshold: Document authenticity

Threshold: Liveness check

10%

10%

Threshold: Name match

10%

10%

IDV API RPOC workflow details (6)

00000001-0001-0002-0001-200000000007

00000000-0001-0002-0001-200000000007

Mobile handoff support

Multi device

Single device

Services:

Doc ID/FaceID

✓/✓

✓/✓

Matcher level

Developer

Developer

Country ID list

DEV2

DEV2

Name verification

false, execute_only

false, execute_only

Document number

false, execute_only

false, execute_only

Date of birth

false, execute_only

false, execute_only

Date of expiry

false, execute_only

false, execute_only

Document supported

false, execute_only

false, execute_only

Address match

false, execute_only

false, execute_only

Document authenticated

false, execute_only

false, execute_only

Face similarity

false, execute_only

false, execute_only

Person alive

false, execute_only

false, execute_only

Selfie authenticity

false, execute_only

false, execute_only

Threshold: Similarity

10%

10%

Threshold: Selfie authenticity

10%

10%

Threshold: Document authenticity

10%

10%

Threshold: Liveness check

10%

10%

Threshold: Name match

10%

10%

IDV API RPOC workflow details (7)

00000001-0001-0002-0002-200000000007

00000000-0001-0002-0002-200000000007

Mobile handoff support

Multi device

Single device

Services:

Doc ID/FaceID

✓/✓

✓/✓

Matcher level

UAT

UAT

Country ID list

UAT2

UAT2

Name verification

true, affects_verification_status

true, affects_verification_status

Document number

false, execute_only

false, execute_only

Date of birth

true, execute_only

true, execute_only

Date of expiry

true, affects_verification_status

true, affects_verification_status

Document supported

true, affects_verification_status

true, affects_verification_status

Address match

false, execute_only

false, execute_only

Document authenticated

false, execute_only

false, execute_only

Face similarity

true, affects_verification_status

true, affects_verification_status

Person alive

true, affects_verification_status

true, affects_verification_status

Selfie authenticity

true, affects_verification_status

true, affects_verification_status

Threshold: Similarity

70%

70%

Threshold: Selfie authenticity

80%

80%

Threshold: Document authenticity

65%

65%

Threshold: Liveness check

90%

90%

Threshold: Name match


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, our interactive help assistant