Sandbox

The Identity API is included in a Sandbox environment to test possible verification scenarios and statuses before accessing to live data. Therefore, set of non-real verification scenarios and statuses were created.

 

Flow

1. Obtain access token - POST /identity/sandbox/auth/oauth/v2/token

Response example: 

{

"access_token":"1234567898765434533334567865",

"token_type":"Bearer",

"expires_in":86400,

"scope":"IDENTITY"

}

2. Create application- POST /identity/sandbox​/v1​/identity/session

After Create the session, choose one of the verification scenarios displayed below. After the selection of scenario the session status will be changing automatically after approximately 2 minutes.

Verification status scenario types

Scenario type

 

CANCELATION 

NEW -> IDENTIFICATION_IN_PROGRESS -> CANCELED

EXPIRATION

NEW -> EXPIRED

FAILURE

NEW -> IDENTIFICATION_IN_PROGRESS -> FAILED

REJECTION

NEW -> IDENTIFICATION_IN_PROGRESS -> REJECTED

DONE

NEW -> IDENTIFICATION_IN_PROGRESS -> DONE

 

3. DELETE /identity/sandbox/v1/identity/sessions/{sessionId}

  • NOT_ALLOWED_OPER - Request is already in status that can not be canceled.
  • APP_NOT_FOUND - Request with specific request ID does not exist.  

4. GET /identity/sandbox​/v1​/identity/sessions/{sessionId}/status

  • APP_NOT_FOUND - Request with specific request ID does not exist.
  • OK - status received 

5. GET /identity/sandbox​/v1​/identity/sessions/{sessionId}/result

  • APP_NOT_FOUND - Request with specific request ID does not exist.
  • OK - status received 
  • Result return data only for Rejection and Done scenario
    • Rejection: return rejectionReasonCode = LIVENESS_CHECK_FAILED
    • Done: return filled out the whole output by swagger

 

Sandbox limitations and conditions

  • Sandbox offline processing changes status scenarios after two minutes, until the session is at final status.
  • Sandbox sessions will be automatically deleted after 30 days
  • Sandbox is limited to process maximum 10 requests at the same time. After scenario selection, session in Sandbox is automatically processes in 4 minutes.
  • Sandbox does not utilize real HMAC session