API Signing Process

How identification and remote signing work end-to-end

Our signing API is built around three parties — Simplifi (us), the Client (your platform) and the Subject (the end user). The flow has two phases: identification followed by the issuing of a 3-year certificate, followed by OTP-based signatures.

Flow available to clients that have a reasonably secure authentication system for their users.

The three parties

Simplifi
Simplifi

Trust service provider — issues certificates and orchestrates signing.

Client
Client

Your platform — integrates our API and owns the user relationship.

Subject
Subject

The end user being identified and signing the documents.

Client
Simplifi
Subject
SMS OTP
Signed
01

Phase 1 — Identification & Certificate Issuance

One-time, valid for 3 years

Step 1
Client

Client redirects

The Client redirects the Subject to Simplifi's secure identification page.

Step 2
Simplifi

Onboarding & remote ID

We onboard the Subject and perform remote identification (KYC, liveness, document scan).

Step 3
Simplifi

Webhook callback

Once complete, we call the Client's webhook with the identification data and certificate reference.

3-year certificate issued
02

Phase 2 — Document Signing

Repeatable, OTP-based, real-time

Step 1
Client

Sign request

The Client calls our API with the document (or its hash) to be signed by the Subject.

Step 2
Simplifi

OTP delivery

Simplifi sends an SMS with a one-time code to the Subject's phone.

Step 3
Subject

Subject enters OTP

The Subject types the OTP inside the Client's app — never leaves the Client UI.

Step 4
Client

Finalize signing

The Client forwards the OTP to our API; we validate it and finalize the signature.

Signed document returned

Legend

Simplifi action
Client action
Subject action

All API calls are authenticated with your API key over HTTPS. Webhook callbacks are signed so you can verify their authenticity.