Socure SDK Integration

Socure SDK 5.0 Integration

📘

We at GD have updated our IDV and CIP processes. This will affect the enrollment process and requires a new SDK integration from Socure.

A user may need to verify their identity in certain situations, including:

  • Enrollment: If we cannot establish a user's identity, we must validate it using official identity documents.
  • Suspicious Activity: Following enrollment, if any suspicious activity is detected on the user's account, it may be temporarily locked until identity documents are verified.

To validate a user's identity, we employ the Socure Doc V SDK. Users must upload their ID documents along with a live selfie to complete the identity verification process. This information will be analyzed to ensure successful verification.

  • For IDV workflow, the Socure SDK needs to be integrated within a partner's website and mobile apps. With Socure SDK, customers will be redirected to a Socure-enabled page where they can upload both the front and back images of their ID documents along with a selfie in real-time using their smartphones. Once the documents are successfully uploaded, that SDK will generate a unique document ID, which will then be used to validate users' identity.
  • For CIP, there won't be any changes from the customer's perspective, except for the optional step of capturing the customer’s consent to search their SSN record against the public SSA repository. This step is up to partner preference.

High Level Steps

From an API integration perspective, the identity validation process involves four key steps:

  1. Fetch the docvTransactionToken by calling the DocumentRequest API:
    POST /programs/{programCode}/accounts/{accountIdentifier}/socureDocumentRequest
    
    Refer: IDV Document Request
  2. Initialize the Socure SDK 5 using the SDK key and the DocvTransactionToken. (The SDK key will be provided by Green Dot to the partner. Please contact your account manager at Green Dot to obtain the SDK Key.)
  3. Document Capture: Ensure that the user successfully completes the document capture and upload process.
  4. API Call: After the user has uploaded their documents, call the API:
    POST /programs/{programCode}/accounts/{accountIdentifier}/users/{userIdentifier}/kycGates/idvsocure
    

Refer: IDV Socure request

Identity Verification Results

The outcomes of the identity verification process determine the next steps: if approved, the user can access their account. If the ID is unreadable, the user has the option to retry the verification process. However, if the ID verification fails, the account will be permanently locked, and further access will be denied.

Next Steps

For more technical and in-depth integration guides, please refer to the iOS Socure SDK, Android Socure SDK, or Web Socure SDK pages, as well as the Callback Methods page.