# كيف أربط Culqi بمتجري؟

يتيح Culqi لعملائك في بيرو الدفع بالبطاقة أو Yape أو PagoEfectivo على صفحة دفع Culqi، باستخدام حسابك الخاص. يقبل السول (PEN) أو الدولار الأمريكي (USD)، لذلك لا يظهر عند الدفع إلا إذا كانت أسعارك بإحدى هاتين العملتين.

## الخطوات

1. في **CulqiPanel > Development > API keys** انسخ **المفتاح العام** و**المفتاح السري**. مفاتيح الاختبار تبدأ بـ `pk_test_` و`sk_test_`.
2. في Dropify اذهب إلى **التطبيقات**، وابحث عن **Culqi** واضغط **تثبيت وربط**.
3. في صفحة التطبيق اضغط **ربط Culqi**، واكتب **اسم الحساب**، واملأ **المفتاح العام** و**المفتاح السري**، ثم اضغط **إضافة حساب**. يتحقق Dropify من المفاتيح لدى Culqi قبل الحفظ.
4. موصى به: تحت **رابط Webhook** اضغط **نسخ رابط Webhook** وأضفه في Culqi (**CulqiPanel > Events > Webhooks**، للحدثين order.status.changed وcharge.creation.succeeded). من خلاله تؤكد مدفوعات PagoEfectivo.
5. في قسم **الإعدادات** اختر **وضع الاختبار** للتجربة أو **الوضع المباشر** للمدفوعات الحقيقية، مع المفاتيح المناسبة.
6. اذهب إلى **المدفوعات > طرق الدفع** وفعل Culqi. يمكنك أيضا تحديد **خصم للطلبات المدفوعة مسبقا** له.
7. اطلب طلبا تجريبيا بعملة PEN أو USD وادفع في صفحة الاختبار لدى Culqi.

## مشاكل شائعة

- "رفضت Culqi هذه المفاتيح في وضع الاختبار…" ← مفاتيح الوضع الآخر أو نسخت مع مسافات. انسخها من جديد أو غير الوضع في **الإعدادات**.
- لا يظهر Culqi عند الدفع ← أسعارك (أو عملة الزائر) ليست بعملة PEN أو USD، أو Culqi غير مفعل في **المدفوعات > طرق الدفع**.
- يرى العميل "لقد الغيت عملية الدفع. يمكنك المحاولة مرة اخرى او اختيار وسيلة دفع اخرى." ← تم إلغاء الدفع في صفحة Culqi. إذا غادر الصفحة فقط يبقى الطلب قيد الانتظار.
- يبقى الطلب المدفوع لاحقا غير مدفوع ← رابط Webhook غير مضاف في Culqi. أضف الرابط الظاهر في صفحة التطبيق (الخطوة 4).

## ذات صلة

- [كيف أربط Openpay بمتجري؟](https://help.dropify.shop/ar/payments_gateways/openpay/)
- [كيف أربط PayU بمتجري؟](https://help.dropify.shop/ar/payments_gateways/payu-latam/)
- available payment gateways by country
