Stearns/Sardine Integration

Links to Helpful Documentation

Get Started with SDK Integration

Required Privacy Disclosures

Best Practices

Session Key Design Guide

Integrate Sardine SDK

📘

What do I need the Sardine SDK for?

The Sardine SDK will primarily be used for the KYC/KYB process. You will use the Sila specs for making requests to the /register and /check_kyc endpoints but the application itself will be routed through the Sardine process.

Please use Sardine's documentation to get started with the Risk SDK:

Getting Started

🚧

Please Note

Sila is handling both Auth and Webhook setup, so do not worry about those.

You will also see documentation on Devices and Signals, which are not relevant to the Sila integration.

Setup:

1. Generate Sardine Sandbox credentials

2. Choose the SDK you need

   

   

3. Use Integration Guides to install the SDK

   

KYC Level

👍

KYC API Calls

Please see our /request_kyc documentation for code samples demonstrating the Sardine KYC Levels.

The KYC Level names for Sardine's KYC are different from Sila's:

• KYC

• KYB

KYB requires no level to be submitted. Please leave out when calling /request_kyc for a business entity.

Doc Verification Flow

1. Make a call to this endpoint: /sardine_doc_verification_link
2. This will retrieve a URL you can direct the end user to, and Sardine will handle the rest.
3. You will receive a webhook updating the IDV status.

Sardine Session Key

Some calls will require a customer-generated session key. Please use Sardine's session key design guide for guidance.

📘

Use 24-hour Expiry

While the docs recommend 30 minutes, a longer expiry is better for the Sila/Stearns integration.

The sardine_session_key is required for:

1. KYC - can be supplied during the initial /register call or can be added later with /add/
2. Doc Verification - sardine_session_key is required to retrieve the verification link, when calling /sardine_doc_verification_link

The sardine_session_key is optional for transacting (see /issue_sila and /redeem_sila)

👍

Session Key API Call Code Samples

Please see the individual doc pages linked above for code samples including the Sardine session key.