Integration Guide

From API Keys to Live Secondary Market

Sayyal is infrastructure. Your platform integrates our APIs and SDKs. Your users gain secondary market access without ever leaving your product — and without creating a Sayyal account.

Request API Access View Product

Authenticate and Sync Positions

Generate API credentials from the Sayyal dashboard. Our read-only sync imports your active loan positions automatically — no manual data entry, no changes to your core system.

The sync is read-only. Sayyal never has write access to your platform. Positions are imported via a secure REST endpoint and kept current via polling or webhook subscription.

step-01.ts

const sayyal = new Sayyal({ apiKey: process.env.SAYYAL_API_KEY });
await sayyal.positions.sync({ platformId: 'plat_abc123' });

Embed the UI or Go Headless

Use our white-label React components — fully themeable to match your brand — or build a completely custom UI on top of the headless REST API. Your users never see the Sayyal name.

White-label components ship with a design token system. Pass your brand colors and typography and they adapt automatically. Headless mode gives you full control over every pixel.

step-02.ts

import { SecondaryMarket } from '@sayyal/react';

<SecondaryMarket
  theme={yourBrandTokens}
  positionId={pos.id}
  onSettled={(transfer) => updateOwnership(transfer)}
/>

Sayyal Runs the Market

Once a position is listed, Sayyal's matching engine, compliance layer, and settlement infrastructure handle everything. Your team has zero operational overhead for secondary market activity.

Matching runs in real time across all positions listed on your platform. KYC/AML checks run on all participants. Settlement completes in T+2 with a full audit trail.

step-03.ts

// Sayyal handles this automatically:
// - Bid/ask matching
// - KYC/AML verification
// - Legal transfer documentation
// - T+2 fund settlement

Receive Webhooks on Completion

When a transfer settles, Sayyal fires a webhook to your platform endpoint. Update your ownership records in real time — no polling, no manual reconciliation.

Webhooks are signed with your secret key. Retry logic handles transient failures. Every event is logged and replayable from the Sayyal dashboard.

step-04.ts

app.post('/webhooks/sayyal', (req, res) => {
  const event = sayyal.webhooks.verify(req);
  if (event.type === 'listing.settled') {
    await updateOwnership(event.data);
  }
  res.sendStatus(200);
});

Integration Questions

No. Sayyal is invisible to your users. They interact with your platform's UI — powered by Sayyal infrastructure in the background. No Sayyal branding, no separate account, no redirect.

Most platforms complete a basic integration in 2–4 weeks. Full white-label deployment with custom UI typically takes 4–8 weeks depending on your team's capacity and the complexity of your existing system.

Sayyal runs KYC/AML checks on all secondary market participants, monitors transactions against CMA and SAMA requirements, and generates the audit trail your platform needs for regulatory reporting.

Ready to Integrate?

Talk to our integration team. We'll walk you through the API, the compliance layer, and what a deployment looks like for your platform.

Request API Access