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

> اقبل البطاقات وInstant EFT وMasterpass في جنوب أفريقيا عبر حسابك الخاص في Payfast. في الإعدادات > المدفوعات، اضغط إعداد Payfast، والصق Merchant ID وMerchant Key وPassphrase، واختر المباشر أو Test، ثم فعّله واضغط حفظ الإعدادات.

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

Payfast مزوّد دفع للشركات في جنوب أفريقيا. عندما تربط حسابك في Payfast، يستطيع عملاؤك الدفع بالبطاقة، أو عبر Instant EFT من مصرفهم الخاص، أو باستخدام Masterpass. تذهب المدفوعات مباشرة إلى حسابك في Payfast، ولا تأخذ Shoprocket أي نسبة (0%).

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

## قبل أن تبدأ

تحتاج إلى حساب في Payfast وثلاث معلومات من لوحة تحكم Payfast:

1. **Merchant ID** و**Merchant Key**، من **Settings > Merchant Details**.
2. **Passphrase**. إذا لم تحدده بعد، فأضفه في **Settings > Integration**. اختر عبارة طويلة لا تستخدمها في أي مكان آخر. يستخدمها Payfast لتوقيع كل دفعة، لذا يجب أن يطابق Passphrase في Shoprocket ما هو في Payfast تمامًا.

## اربط Payfast

1. في لوحة التحكم، انتقل إلى **الإعدادات > المدفوعات**.
2. في بطاقة Payfast ضمن **بوابات الدفع**، اضغط **إعداد Payfast**.
3. الصق **Merchant ID** و**Merchant Key** و**Passphrase** في الحقول التي تحمل الأسماء نفسها.
4. ضمن **Mode**، اختر **مباشر**.
5. اضبط مفتاح Payfast على **مفعّل** واضغط **حفظ الإعدادات**.

![بطاقة Payfast في الإعدادات > المدفوعات: حقول Merchant ID وMerchant Key وPassphrase والوضع](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

عند الحفظ، تتحقق Shoprocket من Merchant ID وPassphrase لدى Payfast. وإذا رفضهما Payfast، فلا يُحفظ شيء وتظهر رسالة في أعلى الشاشة تذكر السبب. أكثر الأخطاء شيوعًا هو أن يختلف Passphrase عن الموجود في **Settings > Integration**، ولو بمسافة في آخره.

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

لا حاجة إلى إعداد webhook. تُخبر Shoprocket نفسها Payfast بالجهة التي يُبلّغ إليها عن كل دفعة. وقبل أن تضع علامة «مدفوع» على أي طلب، تتحقق من هذا البلاغ لدى Payfast.

## يقبل Payfast الراند فقط

يقبل Payfast المدفوعات بالراند الجنوب أفريقي (ZAR). تعرض البطاقة **يقبل حسابك في Payfast المدفوعات بعملة ZAR.** بعد أن تحفظ.

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

## جرّبه بحساب sandbox في Payfast

بيئة الاختبار في Payfast حساب منفصل. سجّل فيه من sandbox.payfast.co.za. وله Merchant ID وMerchant Key وPassphrase خاصة به.

لتجربة صفحة الدفع دون تحريك أموال حقيقية:

1. اضغط **تعديل بيانات اعتماد Payfast**.
2. الصق Merchant ID وMerchant Key وPassphrase من حساب **sandbox**.
3. ضمن **Mode**، اختر **Test (حساب sandbox في Payfast)** ثم اضغط **حفظ الإعدادات**.

تعرض البطاقة عندها **بيانات اختبار: لا تُحرَّك أي أموال حقيقية**. في وضع الاختبار، يأخذ **ادفع الآن** العميل إلى صفحة الدفع التجريبية في Payfast بدل فتح النافذة فوق صفحة الدفع لديك، لأن بيئة sandbox في Payfast لا توفر تلك النافذة. ادفع باستخدام إحدى بطاقات الاختبار من Payfast، فتعود إلى متجرك والطلب مؤكَّد.

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

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

- **بالبطاقة**: يكتب العميل بيانات بطاقته في نافذة Payfast. وإذا احتاج مصرفه إلى التحقق من الدفعة، فيُفتح التحقق هناك أيضًا.
- **بـ Instant EFT**: يسجّل العميل الدخول إلى مصرفه الخاص في نافذة Payfast ويوافق على الدفعة. يتأكد الطلب فور أن يُبلغنا Payfast بوصول المال.
- **بـ Masterpass**: يمسح العميل الرمز بتطبيق مصرفه.

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

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

عندما تسترد مبلغ طلب دُفع عبر Payfast، ترسل Shoprocket الاسترداد إلى Payfast، كليًا أو جزئيًا. راجع [استرداد مبلغ طلب](https://shoprocket.io/ar/help/refund-an-order.md).

لا يسمح Payfast بالاسترداد عبر Shoprocket إلا إذا كان لحسابك في Payfast وصول إلى API. وإن لم يكن كذلك، فيظهر أول استرداد على أنه فشل مع بيان ذلك. استرد المبلغ للعميل من لوحة تحكم Payfast، ثم استرد الطلب مرة أخرى في Shoprocket. عندها تطلب منك Shoprocket التأكيد أنك أرسلت المال بنفسك، وتسجّل الاسترداد على الطلب. الطلبات المدفوعة في وضع الاختبار تُسترد دائمًا بهذه الطريقة، لأن sandbox في Payfast لا يدعم المبالغ المستردة.

تُخصم المبالغ المستردة من رصيدك في Payfast، لذا احرص على أن يكفي لتغطيتها.

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

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

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

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

لإيقاف عرض Payfast، اضبط مفتاحه على **غير مفعّل** واضغط **حفظ الإعدادات**. تبقى بيانات الاعتماد محفوظة، فيمكنك تفعيله مجددًا في أي وقت. أما المدفوعات التي بدأها العملاء بالفعل فستكتمل.

## ذو صلة

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