# اربط حسابك في Xendit

> اقبل البطاقات وQRIS والمحافظ الإلكترونية والتحويلات المصرفية في جنوب شرق آسيا عبر حسابك الخاص في Xendit. في الإعدادات > المدفوعات، اضغط إعداد Xendit، والصق المفتاح السري لـ API ورمز التحقق من webhook، واختر بلدك، وأضف رابط webhook الخاص بنا في Xendit، ثم فعّله واضغط حفظ الإعدادات.

مركز المساعدة / المدفوعات - آخر تحديث 19 نوفمبر 2026

Xendit مزوّد دفع للشركات في إندونيسيا والفلبين وفيتنام وتايلاند وسنغافورة وماليزيا. عندما تربط حسابك في Xendit، يستطيع عملاؤك الدفع بالبطاقة، أو بمسح رمز QRIS، أو بالمحافظ الإلكترونية مثل OVO وDANA وGoPay وShopeePay وGCash وMaya، أو بالتحويل المصرفي إلى حساب افتراضي، أو من منفذ بيع بالتجزئة، بحسب طرق الدفع التي فعّلتها في Xendit. تذهب المدفوعات مباشرة إلى حسابك في Xendit، ولا تأخذ Shoprocket أي نسبة (0%).

عندما يضغط العميل **ادفع الآن**، ينتقل إلى صفحة الدفع الآمنة من Xendit ليختار طريقة الدفع، ثم يعود إلى متجرك. تذهب بيانات البطاقة مباشرة إلى Xendit ولا تمر أبدًا عبر Shoprocket.

## قبل أن تبدأ

تحتاج إلى حساب في Xendit وثلاثة أشياء من لوحة تحكم Xendit:

1. **المفتاح السري لـ API**، من **Settings > API keys**. عند إنشاء المفتاح، امنحه صلاحية الكتابة على **Money-in** ليتمكن من قبول المدفوعات والمبالغ المستردة.
2. **رمز التحقق من webhook**، من **Settings > Webhooks**.
3. البلد الذي سُجّل فيه حسابك في Xendit.

## اربط Xendit

1. في لوحة التحكم، انتقل إلى **الإعدادات > المدفوعات**.
2. في بطاقة Xendit ضمن **بوابات الدفع**، اضغط **إعداد Xendit**.
3. الصق **Secret API key** و**Webhook verification token** في الحقلين اللذين يحملان الاسمين نفسيهما.
4. ضمن **Country**، اختر البلد الذي سُجّل فيه حسابك في Xendit.
5. انسخ **Webhook URL** المعروض أسفل الحقول.
6. في لوحة تحكم Xendit، انتقل إلى **Settings > Webhooks**. الصق الرابط في حقول webhook الخاصة بـ **Payment Session** و**Payments** و**Refunds**، ثم احفظها.
7. عد إلى Shoprocket، واضبط مفتاح Xendit على **مفعّل** واضغط **حفظ الإعدادات**.

![بطاقة Xendit في الإعدادات > المدفوعات: حقول المفتاح السري ورمز webhook والبلد، وتحتها رابط webhook للنسخ](https://shoprocket.io/img/help/connect-xendit/xendit-setup.webp)

عند الحفظ، تتحقق Shoprocket من مفتاحك السري لدى Xendit. إذا رفضه Xendit، فلن يُحفظ شيء، وتوضح رسالة في أعلى الشاشة السبب. أكثر الأخطاء شيوعًا هو لصق المفتاح العام الذي يبدأ بـ `xnd_public_`. أما المفتاح السري فيبدأ بـ `xnd_development_` أو `xnd_production_`.

تعرض البطاقة عندها **متصل**، ويظهر Xendit في صفحة الدفع لديك.

## لماذا يهم رابط webhook

يُكمل كثير من العملاء في جنوب شرق آسيا الدفع خارج متجرك. قد يمسح العميل رمز QRIS بتطبيق مصرفه، أو يوافق على دفعة محفظة إلكترونية من هاتفه، أو يدفع إلى حساب افتراضي بعد ساعات. يُبلغ Xendit كل Shoprocket بكل دفعة عبر رابط webhook. ثم تتحقق Shoprocket من الدفعة لدى Xendit قبل أن تضع علامة «مدفوع» على الطلب.

من دون webhook، قد يبقى الطلب المدفوع بهذه الطريقة **قيد المعالجة** إلى أن يعود العميل إلى متجرك. يُرجى إضافة الرابط في Xendit قبل أن تبدأ البيع.

## العملة التي يقبلها حسابك

يقبل كل حساب في Xendit المدفوعات بعملة بلده: الروبية الإندونيسية أو البيزو الفلبيني أو الدونغ الفيتنامي أو الباخت التايلاندي أو الدولار السنغافوري أو الرينغيت الماليزي. يحدد البلد الذي تختاره العملة، وتعرضها البطاقة بعد الحفظ.

إذا كانت أسعار متجرك بعملة أخرى، تحذّرك البطاقة. لا يمكن أن يكون Xendit بوابة البطاقات الرئيسية في هذه الحالة، لكن يمكنك مع ذلك أن تعرضه على العملاء الذين يدفعون بعملته. ولفعل ذلك، أضف تلك العملة ضمن **بوابة البطاقات حسب العملة**، كما توضح مقالة [اختر بوابة دفع](https://shoprocket.io/ar/help/choose-a-payment-gateway.md).

يقبل Xendit الروبية الإندونيسية بمبالغ صحيحة. إذا كان للسعر كسور، فيُقرَّب إلى أقرب روبية عندما يدفع العميل.

## جرّبه في وضع الاختبار

يمنح Xendit كل حساب وضع اختبار بمفتاح سري خاص به يبدأ بـ `xnd_development_`. الصق مفتاح الاختبار لتجربة صفحة الدفع دون تحريك أموال حقيقية. تعرض البطاقة عندها **بيانات اختبار: لا تُحرَّك أي أموال حقيقية**. وفي صفحة الدفع التجريبية من Xendit يمكنك محاكاة دفعة ناجحة لكل طريقة دفع.

عندما تصبح جاهزًا للبيع، اضغط **تعديل بيانات اعتماد Xendit**، والصق المفتاح السري الفعلي (يبدأ بـ `xnd_production_`)، واختر بلدك مرة أخرى، ثم اضغط **حفظ الإعدادات**. يُضبط رمز التحقق من webhook وروابط webhook بشكل منفصل لوضع الاختبار وللوضع الفعلي في Xendit، لذا أضف الرابط في الوضع الفعلي أيضًا.

## كيف يدفع العملاء

- **بالبطاقة**: يكتب العميل بطاقته في صفحة Xendit. وإذا احتاج مصرفه إلى التحقق من الدفعة، فيُفتح التحقق هناك أيضًا.
- **بـ QRIS أو بمحفظة إلكترونية**: يمسح العميل الرمز أو يوافق على الدفعة في تطبيق محفظته. يتأكد الطلب فور أن يُبلغنا Xendit بنجاح الدفعة.
- **بحساب افتراضي أو من منفذ بيع بالتجزئة**: يحصل العميل على رقم يدفع إليه. يبقى الطلب **قيد المعالجة** إلى أن يدفع، وتبقى المنتجات محجوزة ما دامت صفحة الدفع في Xendit مفتوحة.

إذا غادر العميل صفحة Xendit دون أن يدفع، يمكنه الضغط على **ادفع الآن** مرة أخرى من سلته للعودة إلى الصفحة نفسها. وعند انتهاء صلاحية الصفحة، تُفتح صفحة جديدة.

## المبالغ المستردة

عندما تسترد مبلغ طلب دُفع عبر Xendit، يعود المال إلى العميل تلقائيًا، كاملًا أو جزئيًا. راجع [استرداد مبلغ طلب](https://shoprocket.io/ar/help/refund-an-order.md). بعض المحافظ الإلكترونية وطرق الدفع المصرفية لا يمكن استرداد مبالغها جزئيًا، أو لا يمكن استردادها إطلاقًا، عبر Xendit. إذا حدث ذلك، يظهر الاسترداد على أنه فشل مع ذكر السبب. يمكنك حينها أن تسترد المبلغ كاملًا أو أن تعيد المال إلى العميل بنفسك. والاسترداد الذي تجريه في لوحة تحكم Xendit يظهر أيضًا في الطلب داخل Shoprocket.

تُخصم المبالغ المستردة من رصيدك في Xendit، فاحتفظ برصيد يكفي لتغطيتها.

## الاشتراكات

لا يستطيع Xendit تجديد الاشتراكات على Shoprocket حتى الآن. إذا كنت تبيع اشتراكات، فاحتفظ ببوابة بطاقات أخرى تجددها، مثل Stripe، لتلك المنتجات.

## تغيير بيانات الاعتماد أو إيقافه

بمجرد ربط Xendit، يصبح نص زره **تعديل بيانات اعتماد Xendit**. تُخزَّن بيانات الاعتماد المحفوظة مشفّرة ولا تُعرض مرة أخرى. للإبقاء عليها، اترك الحقول فارغة. ولاستبدالها، املأ الحقول الثلاثة كلها واضغط **حفظ الإعدادات**.

لإيقاف عرض Xendit، اضبط مفتاحه على **متوقف** واضغط **حفظ الإعدادات**. تبقى بيانات اعتمادك محفوظة، فيمكنك إعادة تشغيله في أي وقت. وتكتمل المدفوعات التي كان العملاء قد بدؤوها بالفعل.

## ذو صلة

- [اختر بوابة دفع](https://shoprocket.io/ar/help/choose-a-payment-gateway.md)
- [استرداد مبلغ طلب](https://shoprocket.io/ar/help/refund-an-order.md)
- [قدّم طلبًا تجريبيًا](https://shoprocket.io/ar/help/take-a-test-order.md)

[افتح «المدفوعات» في لوحة التحكم](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/ar/help/connect-xendit
- Language: العربية (ar)
- Also in: [Deutsch](https://shoprocket.io/de/hilfe/xendit-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-xendit.md), [English](https://shoprocket.io/help/connect-xendit.md), [Español](https://shoprocket.io/es/ayuda/conectar-xendit.md), [Français](https://shoprocket.io/fr/aide/connecter-xendit.md), [עברית](https://shoprocket.io/he/help/connect-xendit.md), [हिन्दी](https://shoprocket.io/hi/help/connect-xendit.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-xendit.md), [Italiano](https://shoprocket.io/it/aiuto/collega-xendit.md), [日本語](https://shoprocket.io/ja/help/connect-xendit.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-xendit-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-xendit-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/xendit-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-xendit.md), [Português](https://shoprocket.io/pt/ajuda/conectar-xendit.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-xendit.md), [Русский](https://shoprocket.io/ru/help/connect-xendit.md), [ไทย](https://shoprocket.io/th/help/connect-xendit.md), [Türkçe](https://shoprocket.io/tr/yardim/xendit-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-xendit.md)
