فواتير Paddle: إعداد وأحداث الدفع

ما الذي تتعامل معه Paddle

تعمل Paddle كالتاجر المسجل للمعاملات المؤهلة التي تتم معالجتها من خلال Paddle. تنطبق خدمات الضرائب والفواتير على تلك المعاملات بموجب اتفاقك مع Paddle؛ ربط بوابة لا يجعل كل جزء من العمل متوافقًا في كل ولاية قضائية.

قبل الإعداد

أكمل الموافقة على الحساب والمنتج المطلوبة من قبل Paddle.
استخدم تكامل فواتير Paddle الحالي، وليس بيانات الاعتماد أو أسماء الأحداث من Paddle Classic.
قم بإعداد بيانات اعتماد منفصلة للبيئة التجريبية والحية. احتفظ بمفاتيح API وأسرار webhook على الخادم.

ربط البوابة

افتح إعدادات بوابة الدفع في الإدارة واختر Paddle.
أدخل بيانات الاعتماد المطلوبة من النموذج الحالي، مع سر توقيع webhook.
اختر بيئة التجريب للاختبار. لا تخلط بين رمز التجريب ومفتاح API الحي.
في Paddle، أنشئ وجهة الإشعار لنقطة نهاية webhook الخاصة بتثبيتك.

النقطة المستخدمة من قبل هذا التكامل هي https://your-store.example/api/payment/webhooks/paddle. تأكد من المسار الفعلي لإصدارك المثبت قبل تكوينه.

استخدم أحداث الفواتير الحالية

تستخدم فواتير Paddle أسماء أحداث منقطة. يتم الإبلاغ عن إتمام الدفع باستخدام transaction.completed؛ تستخدم الاشتراكات أحداثًا مثل subscription.created و subscription.updated. اختر الأحداث التي يتعامل معها السائق المثبت لديك. لا تستخدم قائمة Classic القديمة مثل payment_succeeded.

تحقق قبل الذهاب إلى البث المباشر

أكمل عملية شراء في البيئة التجريبية، تحقق من حالة الطلب والمعاملة، وتأكد من قبول webhook الموقع. بالنسبة للمنتجات المتكررة، اختبر الإنشاء، التجديد والإلغاء. يجب ألا تؤدي إشعار مكرر إلى إنشاء تنفيذ ثانٍ أو رسوم.

تأتي موافقة البوابة، المنتجات المدعومة، العملات، الضرائب وشروط الدفع من Paddle. تحقق من الوثائق الحالية الخاصة بهم: webhooks فواتير Paddle.

استكشاف الأخطاء

في حالة فشل المصادقة، تحقق من البيئة وبيانات الاعتماد. في حالة فشل التوقيع، تحقق من سر الوجهة والنقطة النهائية. في حالة وجود طلب معلق، افحص حالة الدفع وwebhook قبل إعادة المحاولة. لا ترسل مفتاح سر في تذكرة الدعم.