WATHBA · PARTNERS

The Standard of
Reseller API
Integration.

دليل تكامل
Reseller API
مع وثبة.

A practical guide for partner teams: enabling Wathba to onboard members and deliver your service through your API.دليل عملي لفرق الشركاء: كيف تتيحون لوثبة تسجيل أعضائها وتقديم خدمتكم لهم عبر API.

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

Four ideas.أربع أفكار.

We’ll cover the partnership, two charging models, API keys and the integration checklist. A practical guide accompanies the presentation.نستعرض الشراكة، ونموذجَي تحصيل الرسوم، ومفاتيح الربط، ومتطلبات التكامل. ويرافق العرض دليل عملي لفريقكم التقني.

One integration makes your service available to Wathba members.تكامل واحد يتيح خدمتكم لأعضاء وثبة.
01
What “reseller” means for youماذا يعني «Reseller» بالنسبة لكم
Each team’s role and responsibilities.دور كل فريق ومسؤولياته.
02
Two ways to collect feesطريقتان لتحصيل الرسوم
Fees deducted from payments, or usage charged to a wallet.رسوم تُخصم من المدفوعات، أو استخدام يُحاسَب عليه من المحفظة.
03
The two keysالمفتاحان
Wathba’s master key and the account keys it protects.مفتاح وثبة الرئيسي، ومفاتيح حسابات الأعضاء التي تتولى حمايتها.
04
The checklistقائمة التحقق
Six requirements for a partner-ready API.ستة متطلبات لتهيئة 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 assistance, without a 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?ثلاث خدمات. ثلاث شركات. ماذا يحدث بعدها؟

In this example, she faces 3 contracts, 3 KYC forms, 3 API guides, and 3 secret keys to store and protect.في هذا المثال، تواجه نورة ٣ عقود، و٣ نماذج KYC، و٣ وثائق API، و٣ مفاتيح سرية تحتاج إلى حمايتها.

×3contractsعقود
×3KYC formsنماذج KYC
×3API docsوثائق API
×3dashboardsلوحات تحكم
×3secret keysمفاتيح سرية
weeksof waitingمن الانتظار
Each service adds setup work. Is there a simpler path?كل خدمة تضيف خطوات جديدة. هل هناك طريق أبسط؟

With Wathba, she requests activation. Wathba handles setup with you, and her app calls one API.مع وثبة، تطلب تفعيل الخدمة. تتولى وثبة إجراءات التسجيل لديكم، ويستخدم تطبيقها API واحدة.

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

A reseller offers your service through its platform.Reseller يتيح خدمتكم لعملائه عبر منصته.

Like a travel agent arranging a flight: the airline operates it and applies its travel requirements.مثل مكتب السفر الذي يرتّب الحجز، بينما تتولى شركة الطيران الرحلة وتطبّق متطلبات السفر.

You manageأنتم تتولون
Service operations and required approvals. Your compliance obligations. Pricing and settlement as agreed.تشغيل الخدمة والموافقات المطلوبة. التزاماتكم التنظيمية. التسعير والتسوية وفق الاتفاق.
Wathba doesوثبة تتولى
Integration and onboarding. Account management, customer support and follow-up. Developer tools and key protection.التكامل والتسجيل. إدارة حسابات العملاء ودعمهم ومتابعتهم. أدوات المطورين وحماية المفاتيح.
Noura getsنورة تحصل على
One Wathba account. One API. Integration documentation her AI tools can follow.حساب واحد في وثبة. API واحدة. وثائق تكامل تناسب أدوات الذكاء الاصطناعي.
02 / 04 · Two waysطريقتان
A gateway like Company X deducts its fee from payments. A prepaid service like Company Y uses a balance funded by Wathba, with usage charged to the member’s wallet.بوابة دفع مثل الشركة X تخصم رسومها من المدفوعات. وخدمة برصيد مسبق مثل الشركة Y تستخدم رصيداً تشحنه وثبة، ويُحاسَب العضو على الاستخدام من محفظته.
Two waysطريقتان
section · two

Model 1: fees deducted from payments.النموذج ١: رسوم تُخصم من المدفوعات.

Wathbaوثبةthe resellerResellerYouأنتمthe providerمزوّد الخدمة01Set up the project accountإعداد حساب المشروعmaster key + the required account informationالمفتاح الرئيسي + بيانات الحساب المطلوبة02You reviewأنتم تراجعونrequired checks and your approval decisionالتحقق المطلوب وقرار الموافقة لديكمpendingactive ✓03Account reference + project keyمرجع الحساب + مفتاح المشروعdelivered securely to Wathba for protected storageتُسلّم إلى وثبة بأمان لحفظها وحمايتها04Payments use the project keyالمدفوعات تستخدم مفتاح المشروعProvider fees come out of payments, not the member’s Wathba wallet.تُخصم رسوم المزوّد من المدفوعات، ولا تُخصم من محفظة العضو في وثبة.

Model 2: Wathba funds a balance.النموذج ٢: وثبة تشحن رصيداً لديكم.

Wathbaوثبةthe resellerResellerYouأنتمthe providerمزوّد الخدمة01Wathba tops up its balanceوثبة تشحن رصيدها لديكمWathba funds its provider accountرصيد مسبق الدفع تملكه وثبة لدى المزوّد02You report balance and usageتتيحون بيانات الرصيد والاستخدامWathba tracks the shared balance and each member’s usageتتابع وثبة الرصيد المشترك واستخدام كل عضو03Wathba requests the serviceوثبة تطلب الخدمة للعضوUsing an application key or scoped partner accessبمفتاح التطبيق أو بصلاحيات شراكة محددة04You debit Wathba’s balanceتخصمون من رصيد وثبةWathba charges the member’s wallet per billable operationوتُحاسب وثبة العضو من محفظته عن كل عملية ذات تكلفةscoped · logged ✓

How do you collect your fees?كيف تُحصّلون رسوم خدمتكم؟

— EXAMPLE · COMPANY X— مثال · الشركة X
Fees from paymentsرسوم من المدفوعات
01You deduct your fee directly from each payment.تخصمون رسومكم مباشرةً من كل عملية دفع.
02Wathba uses the API key assigned to each project.تستخدم وثبة مفتاح API المخصص لكل مشروع.
03Your processing fee does not debit the member’s Wathba wallet.لا تُخصم رسوم المعالجة من محفظة العضو في وثبة.
04Payment gateways such as Company X follow this model.بوابات الدفع مثل الشركة X تتبع هذا النموذج.
— EXAMPLE · COMPANY Y— مثال · الشركة Y
A prepaid service balanceرصيد مسبق الدفع
01Wathba tops up its balance with your service.تشحن وثبة رصيدها لدى خدمتكم.
02Billable operations consume Wathba’s provider balance.تُخصم العمليات ذات التكلفة من رصيد وثبة لديكم.
03Wathba charges the member’s wallet for each billable operation.تُحاسب وثبة العضو من محفظته عن كل عملية ذات تكلفة.
04A shared balance can still use application keys, as in the Company Y example.قد تُستخدم مفاتيح للتطبيقات مع الرصيد المشترك، كما في مثال الشركة Y.
03 / 04 · Keysالمفاتيح
Once we agree on how fees are collected, we choose how Wathba accesses your API. The charging model does not decide key scope: a prepaid balance can still use application keys.بعد الاتفاق على طريقة تحصيل الرسوم، نحدد كيف تصل وثبة إلى API خدمتكم. نموذج التحصيل لا يحدد نطاق المفتاح؛ فالرصيد المسبق يمكن أن يعمل بمفاتيح التطبيقات.
Keysالمفاتيح
section · three

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

You · the hotelأنتم · الفندقyou operate the hotel and set its 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.المفتاح الرئيسي هو هوية وثبة على منصتكم.

A separate key for each environment. It lets Wathba create accounts and check their status. It never reaches member apps, logs or AI assistants.مفتاح مستقل لكل بيئة، يتيح لوثبة إنشاء حسابات الأعضاء ومتابعة حالتها. لا يُشارك مع تطبيقات الأعضاء أو مساعدي الذكاء الاصطناعي، ولا يُسجّل في السجلات.

Stored securely, with agreed procedures for rotation and revocation.يُحفظ بأمان، مع إجراءات متفق عليها لتجديده وإلغائه.
WATHBA · MASTER KEY one per environmentواحد لكل بيئة sandbox · productionsandbox · production Create a member accountإنشاء حساب عضو Read account statusقراءة حالة الحساب List Wathba’s accountsعرض حسابات وثبة Runtime calls using an account keyطلبات التشغيل بمفتاح الحساب

Member keys open one room only, and Wathba protects them.مفاتيح الأعضاء تفتح غرفة واحدة فقط، ووثبة تحميها.

Wathba stores each account key securely. Authorized integration components use it when calling your API for that account.تحفظ وثبة مفتاح كل حساب بأمان، وتستخدمه مكوّنات التكامل المخوّلة عند استدعاء API خدمتكم لذلك الحساب.

Protected in storage. Used by authorized components. Never shared with members or AI assistants.محفوظ بأمان. تستخدمه المكوّنات المخوّلة. ولا يُشارك مع الأعضاء أو مساعدي الذكاء الاصطناعي.
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ذاكرة التشغيل authorized use · during the requestاستخدام مخوّل · أثناء تنفيذ الطلب Your APIAPI الخاص بكمone member’s requestطلب عضو واحد Account keys stay within Wathba’s protected integration systems.تبقى مفاتيح الحسابات داخل أنظمة التكامل المحمية لدى وثبة.
04 / 04 · The standardالمعيار
Six requirements for a partner-ready API. We review what you already support and agree on any changes.ستة متطلبات لتهيئة API خدمتكم للشراكة. نراجع ما هو متاح لديكم، ونتفق على التغييرات المطلوبة.
Standardالمعيار
section · four

The standard in six requirements.المعيار في ستة متطلبات.

01
A partner credentialمفتاح للشراكة
The master key. One per environment, scoped to partner operations, rotatable and revocable.مفتاح مستقل لكل بيئة، بصلاحيات محددة للشراكة، ويمكن تجديده وإلغاؤه.
02
A create-account APIAPI لإنشاء الحساب
Accepts the required account information and returns an account ID. Retries do not create duplicates.يستقبل بيانات الحساب المطلوبة ويعيد معرّفه. ولا يُنشئ حساباً مكرراً عند إعادة الطلب.
03
A way to act for one accountطريقة للتصرف باسم حساب واحد
Account keys or scoped partner access. The charging model does not determine the key type.مفاتيح للحسابات أو وصول شراكة محدد الصلاحيات. نموذج تحصيل الرسوم لا يحدد نوع المفتاح.
04
Account statusحالة الحساب
Documented account states, available by API, with updates when they change.حالات الحساب الموثّقة، متاحة عبر API، مع إشعارات عند تغيّرها.
05
Webhooks that identify the accountإشعارات مرتبطة بالحساب
Every event carries the account id, or each account has its own webhook URL. Signed.يحمل كل إشعار معرّف الحساب، أو يصل عبر رابط مخصص له، مع توقيع للتحقق من المصدر.
06
A representative test environmentبيئة اختبار تمثّل الخدمة
Representative flows, states and test data, with documented production differences.مسارات وحالات وبيانات مناسبة للاختبار، مع توثيق الفروق عن بيئة الإنتاج.

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

These are common points to review when opening an API to partners. We agree on the changes together.هذه نقاط تستحق المراجعة عند إتاحة API خدمتكم للشركاء. نحدد التغييرات المطلوبة معاً.

Automate submission and status tracking while keeping required human approvals.نتيح تقديم الطلب ومتابعته آلياً، مع الإبقاء على الموافقات البشرية المطلوبة.
Dashboard-only onboardingتسجيل عبر لوحة التحكم فقط
Accounts can only be created by a person clicking in your portal.إنشاء الحسابات يتطلب إدخالاً يدوياً في بوابتكم.
Keys sent by email or chatمفاتيح تُرسل بالبريد أو الدردشة
Email and chat make access to credentials harder to control.يصعب ضبط الوصول إلى المفاتيح عند تداولها بالبريد أو الدردشة.
Webhooks without an account idإشعارات بلا معرّف حساب
We receive an event and cannot tell which member it belongs to.نستقبل حدثاً ولا نعرف لأي عضو يعود.
A sandbox that differs from productionبيئة تجريبية تختلف عن الإنتاج
Undocumented differences leave gaps in testing.الفروق غير الموثّقة تترك فجوات في الاختبار.
One key that can do everythingمفتاح واحد يفعل كل شيء
Unrestricted access grants more permissions than the integration needs.الوصول غير المقيّد يمنح التكامل صلاحيات تتجاوز حاجته.

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

Reach Wathba members through one integration. We handle onboarding, account management and customer support.تصل خدمتكم إلى أعضاء وثبة عبر تكامل واحد. ونتولى نحن تسجيل العملاء، وإدارة حساباتهم، ودعمهم.

No need to hire account managers for Wathba customers. We handle their requests and follow-up.لا تحتاجون إلى توظيف مديري حسابات لعملاء وثبة؛ نتولى طلباتهم ومتابعتهم.
growth
More customers through one integrationعملاء جدد عبر تكامل واحد
Connect your service once. New members use the same integration.اربطوا خدمتكم بوثبة مرة واحدة، ويستخدم الأعضاء الجدد التكامل نفسه.
trust
KYC stays yoursقرار KYC يبقى لكم
Wathba coordinates the required information. Your team makes the approval decision.تتابع وثبة استكمال البيانات المطلوبة، ويتولى فريقكم قرار الموافقة.
developers
Docs, SDK, CLI and AI guidanceوثائق وأدوات وإرشادات للذكاء الاصطناعي
AI assistants help build the integration. Member apps call your service through Wathba.يساعد الذكاء الاصطناعي في بناء التكامل، وتستدعي تطبيقات الأعضاء خدمتكم عبر وثبة.
operations
One Wathba team to work withفريق واحد من وثبة للتواصل
We manage customer support and escalate cases that need your team’s action.نتولى دعم العملاء ومتابعتهم، ونصعّد لفريقكم الحالات التي تتطلب تدخّله.

Let’s build it.لنبدأ التكامل.

Four steps toward the first member’s successful use of your service.أربع خطوات نحو أول استخدام ناجح لخدمتكم من أحد الأعضاء.

Technical integration guideدليل التكامل التقني
Architecture, endpoint examples and the two integration paths, written for your engineering team.البنية، وأمثلة نقاط النهاية، ومسارا التكامل، بصياغة موجّهة لفريقكم الهندسي.
Open the integration guide → افتحوا دليل التكامل ← press L for عربياضغط L for English
01
Agree on the charging modelنتفق على نموذج تحصيل الرسوم
Deducted payment fees or a Wathba-funded balance; then agree on API access.رسوم من المدفوعات أو رصيد تشحنه وثبة، ثم نحدد صلاحيات الربط.
02
Arrange secure delivery of a test keyرتّبوا تسليم مفتاح الاختبار بأمان
Include account, usage, balance and webhook documentation as applicable.مع وثائق الحسابات والاستخدام والرصيد والإشعارات بحسب النموذج.
03
We build and verifyنبني ونتحقق
Test setup, operations and charges; verify member wallet debits where applicable.نختبر التسجيل والعمليات والرسوم، ونتحقق من خصم المحفظة حين ينطبق.
04
Go live togetherنطلق معاً
Complete production approvals, then verify the first member’s operation.نستكمل موافقات الإنتاج، ثم نتحقق من أول عملية لأحد الأعضاء.
03 / 03
WATHBA.SA
SPEAKER NOTES · شريحة 03
swipe to navigate · اسحب للتنقّل