> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# علامة تجارية مخصصة

> خصص صفحات التحقق ورسائل البريد الإلكتروني وحزم الإثبات الخاصة بك بعلامة مؤسستك التجارية.

يمكن للمستأجرين من المؤسسات تطبيق علامة تجارية مخصصة على صفحات التحقق ورسائل البريد الإلكتروني للمعاملات وحزم الإثبات. قم بتحميل شعارك، واضبط ألوان العلامة التجارية، وعاين التغييرات قبل الحفظ.

> [!NOTE]
>
> تتطلب العلامة التجارية المخصصة خطة Business أو Enterprise، أو إضافة White-Label
> إضافة. راجع [الفواتير](https://docs.truthlocks.com/ar/billing/overview.md) للحصول على تفاصيل الخطة.

## إعدادات العلامة التجارية

انتقل إلى **الإعدادات > العلامة التجارية** في وحدة التحكم لتكوين علامتك التجارية.

### الشعار

قم بتحميل شعار مؤسستك. يظهر الشعار في صفحات التحقق ورسائل البريد الإلكتروني للمعاملات وبطاقات الاعتماد.

| المتطلب | القيمة |
| :- | :- |
| التنسيقات | PNG، JPEG، SVG، WebP |
| الحد الأقصى لحجم الملف | 2 ميجابايت |

### اسم العلامة التجارية

عيّن الاسم المعروض في صفحات التحقق وبطاقات الاعتماد. هذا عادةً ما يكون اسم مؤسستك أو منتجك.

### الألوان

قم بتكوين لونين يحددان مظهر علامتك التجارية:

| اللون | مكان ظهوره | الافتراضي |
| :- | :- | :- |
| **أساسي** | رؤوس البطاقات، عناصر واجهة المستخدم الأساسية | `#06b6d4` |
| **اللكنة** | الشارات، العلامات، التمييزات الثانوية | `#0891b2` |

استخدم منتقي الألوان أو أدخل قيمة سداسية عشرية مباشرة (على سبيل المثال، `#1a2b3c`).

## معاينة مباشرة

تتضمن صفحة العلامة التجارية لوحة معاينة مباشرة تعرض كيفية ظهور شعارك واسم علامتك التجارية وألوانك على بطاقة الاعتماد. تتحدث التغييرات في الوقت الفعلي أثناء تعديل الإعدادات.

## تكوين العلامة التجارية

**1. تحميل شعارك**

انقر فوق منطقة التحميل أو اسحب وأفلت ملف شعارك. يتم تحديث المعاينة
فورًا.

**2. تعيين اسم علامتك التجارية**

أدخل اسم مؤسستك في حقل اسم العلامة التجارية.

**3. اختر ألوانك**

استخدم منتقي الألوان لتعيين الألوان الأساسية والمميزة، أو أدخل رمز سداسي
القيم مباشرة.

**4. حفظ**

انقر فوق **حفظ العلامة التجارية** لتطبيق تغييراتك. يظهر شعار تأكيد
يظهر عند اكتمال الحفظ.

## إدارة العلامة التجارية عبر واجهة برمجة التطبيقات

يمكنك قراءة وتحديث إعدادات العلامة التجارية برمجيًا. تتطلب جميع نقاط نهاية الكتابة استحقاق White-Label.

### الحصول على العلامة التجارية الحالية

```http Request theme={null}
GET /v1/settings/branding
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "tenant_id": "tn_abc123",
  "brand_name": "Acme Corp",
  "logo_url": "https://cdn.truthlocks.com/branding/tn_abc123/logo/logo.png",
  "primary_color": "#10b981",
  "accent_color": "#059669"
}
```

إذا لم يتم تكوين أي علامة تجارية، فإن الاستجابة تُرجع الألوان الافتراضية (`#06b6d4` أساسي، `#0891b2` مميز) ولا يوجد شعار.

### تحديث العلامة التجارية

عيّن اسم علامتك التجارية وألوانها في طلب واحد:

```http Request theme={null}
PUT /v1/settings/branding
X-API-Key: tl_live_...
Content-Type: application/json

{
  "brand_name": "Acme Corp",
  "primary_color": "#10b981",
  "accent_color": "#059669"
}
```

يجب أن تكون الألوان قيمًا سداسية عشرية صالحة بتنسيق `#RRGGBB`. تحتفظ الحقول المحذوفة بقيمها الحالية.

### تحميل شعار

تستخدم عمليات تحميل الشعار تدفق URL موقع مسبقًا من ثلاث خطوات:

**1. طلب عنوان URL لتحميل موقع مسبقًا**

```http Request theme={null}
POST /v1/settings/branding/logo/presign
X-API-Key: tl_live_...
Content-Type: application/json

{
  "filename": "logo.png",
  "content_type": "image/png",
  "size_bytes": 48000
}
```

```json Response theme={null}
{
  "upload_url": "https://s3.amazonaws.com/...",
  "s3_key": "branding/tn_abc123/logo/ast_xyz/logo.png",
  "asset_id": "ast_xyz",
  "expires_in": 600
}
```

تنتهي صلاحية عنوان URL الموقّع مسبقًا بعد 10 دقائق.

**2. تحميل الملف إلى عنوان URL الموقّع مسبقًا**

قم بتحميل شعارك مباشرةً إلى `upload_url` باستخدام طلب HTTP PUT مع محتويات الملف كجسم للطلب.

**3. تأكيد التحميل**

```http Request theme={null}
POST /v1/settings/branding/logo/confirm
X-API-Key: tl_live_...
Content-Type: application/json

{
  "asset_id": "ast_xyz",
  "s3_key": "branding/tn_abc123/logo/ast_xyz/logo.png"
}
```

بعد التأكيد، يظهر الشعار الجديد على جميع أسطح العلامة التجارية.

> [!WARNING]
>
> تُرجع نقاط نهاية الكتابة (`PUT /v1/settings/branding`، وتوقيع الشعار المسبق، وتأكيد الشعار) HTTP 402 إذا كانت خطتك لا تتضمن استحقاق White-Label. راجع [الفواتير](https://docs.truthlocks.com/ar/billing/overview.md) للحصول على تفاصيل الخطة.

## أين تظهر العلامة التجارية

يتم تطبيق علامتك التجارية المخصصة عبر عدة أسطح:

> [card] صفحات التحقق
>
> تعرض صفحات الإثبات العامة شعارك وألوان علامتك التجارية.

> [card] رسائل البريد الإلكتروني للمعاملات
>
> رسائل البريد الإلكتروني المرسلة نيابة عنك (مثل تسليم بيانات الاعتماد، ودعوات الفريق)
> تضمين شعارك.

> [card] حزم الإثبات
>
> تشير حزم الإثبات التي تم تنزيلها إلى اسم علامتك التجارية وهوية المُصدر.

> [card] بطاقات الاعتماد
>
> تستخدم بطاقة الاعتماد المعروضة للمستلمين لونك الأساسي وشعارك.

## الأذونات

يتطلب تحديث إعدادات العلامة التجارية إذن `branding.write`، والذي يتم منحه لأدوار **مسؤول المستأجر** و**مسؤول المنظمة** افتراضيًا. يمكن لأي مستخدم مصادق عليه لديه `settings.read` عرض إعدادات العلامة التجارية.

## ذات صلة

> [card] [الفوترة](https://docs.truthlocks.com/billing/overview.md)
>
> خطط للمستويات والإضافة ذات العلامة البيضاء.

> [card] [تسليم B2B2C](https://docs.truthlocks.com/guides/b2b2c.md)
>
> كيف يتم تسليم بيانات الاعتماد ذات العلامة التجارية للمستهلكين.

> [card] [نطاقات مخصصة](https://docs.truthlocks.com/guides/custom-domains.md)
>
> قدم بوابة التحقق والوحدة من نطاقك الخاص.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.