SDK & Workflow Builder

Embed verification into any app in minutes

Compile, configure and deploy the Farmsky client SDKs to run KYC, biometrics, watchlist and credit-scoring flows directly inside your native mobile and web applications.

Build a workflow

Live demo uses the public sandbox workflow wf_sandbox.

Build SDKs in three steps

Install / compile

Add the SDK via CDN (web), npm, Gradle (Android) or Swift Package Manager (iOS). No secret keys are bundled — the SDK only carries your public workflow Client ID.

Configure

Point the SDK at a published workflow you built in the Console. Set the Client ID + flow ID, and (optionally) redirect / cross-device behaviour.

Deploy

Ship it. Farmsky hosts the verification UI and endpoints; results stream back via callbacks and signed webhooks. Rotate the Client ID any time from the Console if it is exposed.

index.html

<!-- 1. Add the Farmsky Verify SDK -->
<script src="https://score.farmsky.africa/sdk/v1/farmsky.js"></script>

<!-- 2. Launch a verification flow -->
<button id="verify-btn">Verify your identity</button>
<script>
  document.getElementById('verify-btn').addEventListener('click', function () {
    Farmsky.verify({
      clientId: 'wf_sandbox',                 // your workflow Client ID (public)
      flow: '33333333-3333-3333-3333-333333333333',
      onComplete: function (result) { console.log('Verified!', result); },
      onError:    function (err)    { console.error(err); }
    });
  });
</script>

VerifyButton.tsx

import { useEffect } from 'react'

// Load once (e.g. in _app / root layout)
function useFarmsky() {
  useEffect(() => {
    const s = document.createElement('script')
    s.src = 'https://score.farmsky.africa/sdk/v1/farmsky.js'
    s.async = true
    document.body.appendChild(s)
    return () => { document.body.removeChild(s) }
  }, [])
}

export function VerifyButton() {
  useFarmsky()
  return (
    <button onClick={() => window.Farmsky.verify({
      clientId: 'wf_sandbox',
      flow: '33333333-3333-3333-3333-333333333333',
      onComplete: (r) => console.log(r),
    })}>Verify your identity</button>
  )
}

MainActivity.kt

// build.gradle (module)
dependencies {
    implementation "ke.farmsky:verify-android:1.0.0"
}

// Kotlin
val farmsky = FarmskyVerify.Builder(context)
    .clientId("wf_sandbox")               // workflow Client ID (public)
    .flow("33333333-3333-3333-3333-333333333333")
    .onComplete { result -> Log.d("Farmsky", result.toString()) }
    .onError    { err    -> Log.e("Farmsky", err.message) }
    .build()

farmsky.start()

ContentView.swift

// Swift Package Manager
.package(url: "https://github.com/farmsky/verify-ios.git", from: "1.0.0")

// Swift
import FarmskyVerify

let farmsky = FarmskyVerify(
    clientId: "wf_sandbox",                 // workflow Client ID (public)
    flow: "33333333-3333-3333-3333-333333333333"
)
farmsky.onComplete = { result in print("Verified", result) }
farmsky.onError    = { error  in print(error) }
farmsky.start(from: self)

terminal

# Start a verification session (no SDK required)
curl -X POST https://score.farmsky.africa/v3/verify/sessions \
  -H "X-Workflow-Client: wf_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"flow":"33333333-3333-3333-3333-333333333333"}'

# Submit each step, then read the final result.
curl -X POST https://score.farmsky.africa/v3/verify/sessions/<SESSION_ID>/steps/document \
  -H "X-Workflow-Client: wf_sandbox"

No-code Workflow Builder

Design the journey. We generate the SDK.

Drag verification blocks onto a canvas, set compliance rules, and publish. Every workflow gets a Client ID, ready-made SDK snippets and signed webhooks — no glue code.

Visual flow canvas

Arrange Document, Biometric, Watchlist, Gov DB, Credit and Custom blocks in sequence.

Workflow settings

Certified timestamps, GDPR retention, cross-device redirect, DB timeouts and retry blocking.

Integration menu

Reveal your Client ID, copy SDK snippets, register webhooks and regenerate keys instantly if compromised.

Tiered modules

Free and premium blocks. Adding a premium block prompts an inline upgrade.

Cross-device

Hand users off from desktop to mobile via QR or email mid-verification.

M-Pesa checkout

Unlock premium modules and publish with instant M-Pesa mobile-money payment.

Open the Workflow Builder