Marketplace seller KYB
Know every seller on your marketplace.
Marketplace trust starts with knowing who is selling. Amani verifies registered businesses against official registries, identifies their owners, and runs full identity checks on individual sellers - before the first listing goes live.
The challenge
Fraudulent sellers, undisclosed owners and sanctioned entities expose marketplaces to consumer harm, chargebacks and regulatory action under platform-liability rules.
With Amani
- Business existence and status verified at source
- Owners and directors identified and screened
- Sole traders verified with full KYC
- Sanctioned and high-risk sellers blocked at onboarding
- Re-screening as seller details change
The stack
Modules powering this flow.
Switch these on in Amani Studio - or call them directly from one API.
KYB - Business Verification
On requestVerify businesses, owners and directors in one flow.
ExploreKYC
$0.35Onboard real customers. Block fraud in seconds.
ExploreAML / Sanctions Screening
$0.20Screen every user. Stay screened forever.
ExploreAddress Verification
$0.20Proof of address, verified automatically.
ExploreFor developers
Build this flow.
Three API calls start the session; the modules above run inside it. Compose the journey in Amani Studio without code, or let your AI coding agent wire up the SDK from a single prompt.
- JWT auth with refresh tokens
- Regional base URLs (EU · TR · UAE)
- HMAC-signed webhooks with retries
- 27 languages in the SDKs
verify.sh
# 1 · Authenticate (server-side only)
curl -X POST 'https://ae.amani.ai/api/v2/user/login/' \
--form 'username="you@company.com"' \
--form 'password="••••••••"'
# 2 · Create the customer profile
curl -X POST 'https://ae.amani.ai/api/v2/profile' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
--form 'id_card_number="784199012345678"' \
--form 'name="Layla Haddad"'
# 3 · Generate the verification URL
curl -X POST 'https://ae.amani.ai/api/v2/profile/url' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
--data '{
"profile": PROFILE_ID,
"web_sdk_url": "https://verify.amani.ai",
"language": "en",
"return_url": "https://yourapp.com/verified"
}'
# This session runs: KYB - Business Verification, KYC, AML / Sanctions Screening, Address Verification.with Amani Skills
# Install Amani Skills once
npx -y github:AMANI-AI-ORG/skills --global
# Then ask your coding agent:
You › In our Node backend, create an Amani verification profile for a business customer on signup with the REST API and handle the approved/rejected webhook.
# The matching skill fetches the live docs, pins the
# current SDK version and wires up the integration -
# secrets left as placeholders. Claude Code, Cursor and
# any Agent-Skills-compatible tool.webhooks.ts
// Amani signs every webhook with an HMAC signature using
// your secret. Always verify it before processing.
import crypto from 'node:crypto';
app.post('/webhooks/amani', (req, res) => {
// Confirm the exact header name in the Webhooks API reference.
const signature = req.get('X-Amani-Signature') ?? '';
const expected = crypto
.createHmac('sha256', process.env.AMANI_WEBHOOK_SECRET)
.update(req.rawBody)
.digest('hex');
const valid =
signature.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
if (!valid) return res.status(401).end();
const { profile, status } = req.body;
if (status === 'approved') activateAccount(profile);
res.status(200).end();
});Marketplace seller KYB - common questions
Can you handle both companies and individuals?
Yes - journeys branch automatically: registered businesses go through KYB, sole traders through KYC.
How long does seller verification take?
Registry-backed business checks typically return within minutes; individual checks in seconds.
Does it support ongoing monitoring?
Yes - sellers and their officers can be re-screened on a schedule with alerts on change.
Related use cases
Build this flow with Amani
Compose it in Studio without code, or integrate the API in an afternoon.