WATHBA · PARTNERS

The Standard of
Reseller API
Integration.

معيار تكامل
Reseller API
للشركاء.

A simple guide for partner tech teams and product managers: how to let Wathba onboard and serve its members on your platform, safely.دليل مبسّط للفرق التقنية ومديري المنتجات لدى شركائنا: كيف تتيحون لوثبة تسجيل أعضائها وخدمتهم على منصتكم بأمان.

Startابدأ →←
PARTNER INTEGRATION · 2026
WATHBA.SA

Four ideas, fifteen minutes.أربع أفكار في خمس عشرة دقيقة.

No code today. Just the idea, the keys, the two ways to connect, and a short checklist. Your engineers get a take-home guide after.لا كود اليوم. الفكرة، والمفاتيح، وطريقتا الربط، وقائمة تحقق قصيرة. وبعدها يحصل مهندسوكم على دليل عملي مرافق.

“Reseller” is a small change on your side with a big result for both of us.«الوكيل» تغيير صغير عندكم بنتيجة كبيرة للطرفين.
01
What “reseller” means for youماذا يعني «الوكيل» بالنسبة لكم
Who does what, and what stays yours.من يفعل ماذا، وما الذي يبقى لكم.
02
The two keysالمفتاحان
Wathba’s master key, and the members’ keys we never see.مفتاح وثبة الرئيسي (master key)، ومفاتيح الأعضاء التي لا نراها أبداً.
03
The two ways to connectطريقتا الربط
Both work. You pick one.كلتاهما تعمل. أنتم تختارون.
04
The checklistقائمة التحقق
Six things that make an API “reseller-ready”.ستة أشياء تجعل الـ API جاهزاً للوكلاء.
01 / 04 · Storyالقصة
Meet Noura. She built an app with AI. Her story shows why Wathba exists, and why we need you.تعرّفوا على نورة. بنت تطبيقاً بالذكاء الاصطناعي. قصتها تشرح لماذا وُجدت وثبة، ولماذا نحتاجكم.
Storyالقصة
section · one
Noura Al-Harbiنورة الحربي
Builds apps with AI agents. No backend team.تبني التطبيقات بوكلاء الذكاء الاصطناعي. بلا فريق خلفي.
illustrative persona · not a real caseشخصية توضيحية · ليست حالة موثقة

Noura built her app in one weekend. Now it needs payments, OTP and a domain.نورة بنت تطبيقها في عطلة واحدة. الآن يحتاج مدفوعات وOTP ونطاقاً.

Three services. Three companies. What happens next?ثلاث خدمات. ثلاث شركات. ماذا يحدث بعدها؟

Without a reseller, she signs 3 contracts, fills 3 KYC forms, reads 3 API docs, and keeps 3 secret keys she doesn’t know how to protect.بدون وكيل، توقّع ٣ عقود، وتعبّئ ٣ نماذج KYC، وتقرأ ٣ وثائق API، وتحتفظ بـ٣ مفاتيح سرية لا تعرف كيف تحميها.

×3contractsعقود
×3KYC formsنماذج KYC
×3API docsوثائق API
×3dashboardsلوحات تحكم
×3secret keysمفاتيح سرية
weeksof waitingمن الانتظار
Most builders stop here. Is there a shorter path?أغلب المطورين يتوقفون هنا. هل هناك طريق أقصر؟

With Wathba, she clicks Enable once. Wathba onboards her to you, and her app talks to one API.مع وثبة، تضغط تفعيل مرة واحدة. وثبة تسجّلها عندكم، ويتحدث تطبيقها مع API واحد.

Noura’s appتطبيق نورةone account · one APIحساب واحد · API واحد Wathbaوثبةthe resellerالوكيل Youأنتمthe provider · your APIمزوّد الخدمة · API الخاص بكم one callطلب واحدyour APIAPI الخاص بكم Wathba onboarded Noura to you, and calls your API on her behalf.وثبة سجّلت نورة عندكم، وتستدعي API الخاص بكم نيابةً عنها.

A reseller sells your service through its own platform.الوكيل يبيع خدمتكم عبر منصته.

Like a travel agent selling airline seats: the airline still flies the plane and checks the passports.مثل وكيل السفر الذي يبيع مقاعد الطيران: شركة الطيران ما زالت تقود الطائرة وتفحص الجوازات.

You keepأنتم تحتفظون بـ
The customer relationship. The KYC decision. Pricing and settlement. Compliance and reporting.علاقة العميل. قرار KYC. التسعير والتسوية. الامتثال والتقارير.
Wathba doesوثبة تتولى
Integration and docs. Onboarding UX. Developer, SDK and AI-agent experience. First-line support. Key custody.التكامل والوثائق. تجربة التسجيل. تجربة المطورين وSDK ووكلاء الذكاء الاصطناعي. الدعم الأولي. حفظ المفاتيح.
Noura getsنورة تحصل على
One account. One API. One agent skill. Hours instead of weeks.حساب واحد. API واحد. مهارة واحدة لوكيلها. ساعات بدل أسابيع.
02 / 04 · Keysالمفاتيح
Two kinds of keys: Wathba’s master key, and one key per member that nobody at Wathba can read.نوعان من المفاتيح: مفتاح وثبة الرئيسي، ومفتاح لكل عضو لا يستطيع أحد في وثبة قراءته.
Keysالمفاتيح
section · two

Think of a hotel.تخيّلوا فندقاً.

You · the hotelأنتم · الفندقyou own the rooms and the rulesأنتم تملكون الغرف والقواعد Wathba · the managerوثبة · المدير holds the master cardيحمل البطاقة الرئيسية MASTER master cardالبطاقة الرئيسية opens the key office onlyتفتح مكتب المفاتيح فقط Room · Nouraغرفة · نورة a member · their own room keyعضو · مفتاح غرفته الخاص Room · Saadغرفة · سعد a member · their own room keyعضو · مفتاح غرفته الخاص Room · Lamaغرفة · لمى a member · their own room keyعضو · مفتاح غرفته الخاص room keys: each opens one room onlyمفاتيح الغرف: كلٌّ يفتح غرفة واحدة فقط

The master key is Wathba’s own identity on your platform.المفتاح الرئيسي هو هوية وثبة على منصتكم.

One credential per environment. It lets Wathba create and read member accounts. It never sits in a member’s app, a log file, or an AI agent.اعتماد واحد لكل بيئة. يتيح لوثبة إنشاء حسابات الأعضاء وقراءتها. لا يوجد أبداً في تطبيق عضو أو ملف سجل أو وكيل ذكاء اصطناعي.

Kept in a cloud secret manager. Rotated on a schedule. Revocable by you at any time.محفوظ في مدير أسرار سحابي. يُدوَّر دورياً. ويمكنكم إلغاؤه في أي وقت.
WATHBA · MASTER KEY one per environmentواحد لكل بيئة sandbox · productionsandbox · production Create a member accountإنشاء حساب عضو Read account statusقراءة حالة الحساب List Wathba’s accountsعرض حسابات وثبة Pay or send for a member (Way 1)الدفع أو الإرسال باسم عضو (الطريقة ١)

Member keys open one room only, and we never see them.مفاتيح الأعضاء تفتح غرفة واحدة فقط، ونحن لا نراها.

The moment a member key arrives, Wathba encrypts it. It is decrypted in memory only for the milliseconds of a request, then it is gone.لحظة وصول مفتاح العضو، تشفّره وثبة. لا يُفكّ تشفيره إلا في الذاكرة لأجزاء من الثانية أثناء الطلب، ثم يختفي.

Stored: ciphertext + fingerprint. Shown to humans: status only. Read by a human: never.المخزّن: نص مشفّر + بصمة. المعروض للبشر: الحالة فقط. ما يقرؤه إنسان: لا شيء.
Youأنتمissue a member keyتصدرون مفتاح عضو Wathba vaultخزنة وثبة enc:•••••••••8f3aenc:•••••••••8f3a arrives onceيصل مرة واحدة encrypted on arrivalيُشفَّر فور وصوله Wathba’s team seesما يراه فريق وثبة connection: active · key: neverالاتصال: فعّال · المفتاح: لا يُعرض أبداً Runtime memoryذاكرة التشغيل plain key · milliseconds · then goneمفتاح مكشوف · أجزاء من الثانية · ثم يختفي Your APIAPI الخاص بكمone member’s requestطلب عضو واحد Nobody at Wathba can read a member key. Not support, not engineers, not the AI agent.لا أحد في وثبة يستطيع قراءة مفتاح عضو. لا الدعم ولا المهندسون ولا وكيل الذكاء الاصطناعي.
03 / 04 · Two waysطريقتان
Two ways to make your API reseller-ready. Both run in production today. You pick the one that fits your accounts.طريقتان لجعل API الخاص بكم جاهزاً للوكلاء. كلتاهما تعمل في الإنتاج اليوم. تختارون ما يناسب حساباتكم.
Two waysطريقتان
section · three

Way 1: you issue a key per member.الطريقة ١: تصدرون مفتاحاً لكل عضو.

Wathbaوثبةthe resellerالوكيلYouأنتمthe providerمزوّد الخدمة01Create accountإنشاء حسابmaster key + the member’s business and KYC dataالمفتاح الرئيسي + بيانات العضو التجارية وKYC02You reviewأنتم تراجعونyour KYC, your decisionKYC الخاص بكم، قراركمpendingactive ✓03Account id + member keysمعرّف الحساب + مفاتيح العضوreturned once, over the API, then encrypted by Wathbaتُعاد مرة واحدة عبر الـ API، ثم تشفّرها وثبة04Runtime: pay, send, verifyالتشغيل: دفع، إرسال، تحققwith the member’s key only. The master key stays out.بمفتاح العضو فقط. المفتاح الرئيسي لا يُستخدم.

Way 2: no member keys. Wathba acts on behalf.الطريقة ٢: بلا مفاتيح أعضاء. وثبة تتصرف نيابةً.

Wathbaوثبةthe resellerالوكيلYouأنتمthe providerمزوّد الخدمة01Create accountإنشاء حسابmaster key + the member’s business and KYC dataالمفتاح الرئيسي + بيانات العضو التجارية وKYC02An account or reference idمعرّف حساب أو مرجعno member keys exist. Nothing secret for Wathba to store.لا توجد مفاتيح أعضاء. لا شيء سري تخزّنه وثبة.03Runtime: master key + account idالتشغيل: المفتاح الرئيسي + معرّف الحسابthe id travels in a header, the path, or the payloadالمعرّف يُرسل في header أو في المسار أو داخل الطلب04You enforce the scopeأنتم تفرضون النطاقthe call touches only that account, and you log it per accountالطلب يمس ذلك الحساب فقط، وتسجّلونه لكل حسابscoped · logged ✓

Both are good. Pick one and we build it.كلتاهما جيدة. اختاروا واحدة ونبنيها.

— WAY 1 · A KEY PER MEMBER
Fits you if…تناسبكم إذا…
01You already issue API keys per merchant or account.تصدرون أصلاً مفاتيح API لكل تاجر أو حساب.
02Members may also log in to your own dashboard.قد يدخل الأعضاء أيضاً إلى لوحة تحكمكم.
03You want the smallest blast radius: one key, one account.تريدون أصغر نطاق ضرر: مفتاح واحد، حساب واحد.
04Each member has their own account and settlement with you.لكل عضو حسابه وتسويته الخاصة معكم.
— WAY 2 · ACT ON BEHALF
Fits you if…تناسبكم إذا…
01You don’t want to mint and rotate thousands of keys.لا تريدون إصدار وتدوير آلاف المفاتيح.
02Accounts are records inside your system, not logins.الحسابات سجلات داخل نظامكم، لا حسابات دخول.
03One credential to rotate, per-account scoping and logs on your side.اعتماد واحد للتدوير، ونطاق وسجلات لكل حساب من جهتكم.
04Wathba pays from a reseller balance and re-bills the member.وثبة تدفع من رصيد الوكيل وتعيد الفوترة على العضو.
04 / 04 · The standardالمعيار
Six things that make an API reseller-ready. None of them is hard. Most partners already have four.ستة أشياء تجعل الـ API جاهزاً للوكلاء. لا شيء منها صعب. أغلب الشركاء لديهم أربعة منها أصلاً.
Standardالمعيار
section · four

The standard in six things.المعيار في ستة أشياء.

01
A partner credentialاعتماد شراكة
The master key. One per environment, scoped to partner operations, rotatable and revocable.المفتاح الرئيسي. واحد لكل بيئة، محدود بعمليات الشراكة، قابل للتدوير والإلغاء.
02
A create-account APIAPI لإنشاء الحساب
Takes business and KYC data. Returns an account id. Safe to retry (idempotent).يستقبل البيانات التجارية وKYC. يعيد معرّف الحساب. آمن عند إعادة المحاولة (idempotent).
03
A way to act for one accountطريقة للتصرف باسم حساب واحد
Way 1: keys per account. Way 2: master key + account id. Either one.الطريقة ١: مفاتيح لكل حساب. الطريقة ٢: المفتاح الرئيسي + معرّف الحساب. أيٌّ منهما.
04
Account statusحالة الحساب
pending, active, rejected, suspended. Readable by API and pushed when it changes.pending، active، rejected، suspended. تُقرأ عبر الـ API وتُدفع عند تغيّرها.
05
Webhooks that name the accountwebhooks تسمّي الحساب
Every event carries the account id, or each account has its own webhook URL. Signed.كل حدث يحمل معرّف الحساب، أو لكل حساب رابط webhook خاص. موقّعة.
06
A sandbox like productionبيئة تجريبية مثل الإنتاج
Same flows, same statuses, test data. We certify there before we go live.نفس المسارات ونفس الحالات وبيانات اختبار. نعتمد هناك قبل الإطلاق.

Where integrations usually break.أين يتعطل التكامل عادةً.

None of these is hard to fix. They exist because nobody asked for them before a reseller showed up.لا شيء منها صعب الإصلاح. وُجدت لأن أحداً لم يطلبها قبل أن يظهر وكيل.

If a human must click a button for each new member, it is not an API yet.إذا كان على إنسان أن يضغط زراً لكل عضو جديد، فهو ليس API بعد.
Dashboard-only onboardingتسجيل عبر لوحة التحكم فقط
Accounts can only be created by a person clicking in your portal.لا تُنشأ الحسابات إلا بنقر شخص في بوابتكم.
Keys sent by email or chatمفاتيح تُرسل بالبريد أو الدردشة
A secret that travels through inboxes is already leaked.السر الذي يمر عبر صناديق البريد مُسرَّب أصلاً.
Webhooks without an account idwebhooks بلا معرّف حساب
We receive an event and cannot tell which member it belongs to.نستقبل حدثاً ولا نعرف لأي عضو يعود.
A sandbox that differs from productionبيئة تجريبية تختلف عن الإنتاج
Different statuses or fields mean the first real member finds the bugs.اختلاف الحالات أو الحقول يعني أن أول عضو حقيقي هو من يكتشف الأخطاء.
One key that can do everythingمفتاح واحد يفعل كل شيء
No scoping means a reseller key is also a full-admin key.غياب النطاق يعني أن مفتاح الوكيل هو أيضاً مفتاح مدير كامل.

What you get.ما تحصلون عليه.

Every Wathba member who enables your service becomes your customer, without another integration project on your side.كل عضو في وثبة يفعّل خدمتكم يصبح عميلاً لكم، دون مشروع تكامل آخر من جهتكم.

You keep the relationship. We remove the friction.أنتم تحتفظون بالعلاقة. ونحن نزيل الاحتكاك.
growth
More customers, zero extra work per customerعملاء أكثر، بلا عمل إضافي لكل عميل
Integrate once with Wathba. Every new member reuses it.تكاملون مرة مع وثبة. وكل عضو جديد يعيد استخدامه.
trust
KYC stays yoursقرار KYC يبقى لكم
Wathba collects and forwards. You decide, exactly as today.وثبة تجمع وتمرّر. وأنتم تقررون، تماماً كما اليوم.
developers
Docs, SDK, CLI and AI agentsوثائق وSDK وCLI ووكلاء ذكاء
Builders and their agents already know how to call your service through Wathba.المطورون ووكلاؤهم يعرفون أصلاً كيف يستدعون خدمتكم عبر وثبة.
operations
One contact, one sandboxجهة اتصال واحدة، بيئة تجريبية واحدة
One partner channel instead of hundreds of merchant tickets.قناة شراكة واحدة بدل مئات تذاكر التجار.

Let’s build it.هيا نبنيها.

Four steps from this meeting to Noura’s first transaction on your platform.أربع خطوات من هذا الاجتماع إلى أول عملية لنورة على منصتكم.

Take-home guide with the checklist and an AI-agent prompt: reseller.ploy.jsa.sa/guide.htmlالدليل المرافق مع قائمة التحقق وبرومبت لوكيل الذكاء الاصطناعي: reseller.ploy.jsa.sa/guide.html
wathba.sareseller.ploy.jsa.sapress L for عربياضغط L for English
01
Choose Way 1 or Way 2اختاروا الطريقة ١ أو ٢
And name one owner on your side.وسمّوا مسؤولاً واحداً من جهتكم.
02
Share a sandbox master keyشاركوا مفتاحاً رئيسياً للبيئة التجريبية
Plus the create-account and webhook specs.مع مواصفة إنشاء الحساب والـ webhooks.
03
We build and certifyنبني ونعتمد
End to end in the sandbox: onboarding, runtime, webhooks, status.من طرف لطرف في البيئة التجريبية: التسجيل، التشغيل، الـ webhooks، الحالة.
04
Go live togetherنطلق معاً
Production master key, first member, first transaction.المفتاح الرئيسي للإنتاج، أول عضو، أول عملية.
03 / 03
WATHBA.SA
SPEAKER NOTES · شريحة 03
swipe to navigate · اسحب للتنقّل