Skip to main content

GitHub Repository

قالب Go + Dodo Payments الجاهز والبسيط

نظرة عامة

يوفر قالب Go الجاهز نقطة بداية جاهزة للاستخدام في بيئة الإنتاج لدمج Dodo Payments مع الواجهة الخلفية المبنية بـ Go. يتضمن هذا القالب معالجة جلسات الدفع، والتحقق من Webhook، ودمج Customer Portal، ويتبع أفضل ممارسات Go لمساعدتك على بدء قبول المدفوعات بسرعة.
يستخدم هذا القالب Go 1.21+ مع أنماط البنية النظيفة (cmd، internal، templates)، وقوالب HTML، وSDK ‏dodopayments-go لتكامل سلس مع API.

الميزات

  • إعداد سريع - ابدأ في أقل من 5 دقائق
  • تكامل الدفع - تدفق Checkout مُعد مسبقًا باستخدام SDK ‏dodopayments-go
  • واجهة مستخدم عصرية - صفحة أسعار بسيطة ذات مظهر داكن باستخدام قوالب HTML
  • معالجة Webhook - التحقق الآمن من أحداث الدفع ومعالجتها
  • Customer Portal - إدارة الاشتراكات ذاتية الخدمة
  • أفضل ممارسات Go - بنية نظيفة باستخدام cmd وinternal وtemplates
  • Checkout مُعبأ مسبقًا - يوضح تمرير بيانات العميل لتحسين تجربة المستخدم

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:
  • Go 1.21+
  • حساب Dodo Payments (للوصول إلى مفاتيح API وWebhook من لوحة التحكم)

البدء السريع

1

Clone the Repository

2

Install Dependencies

أو يدويًا:
3

Get API Credentials

سجّل حسابًا على Dodo Payments واحصل على بيانات الاعتماد من لوحة التحكم:
تأكد من أنك تستخدم الوضع التجريبي أثناء التطوير!
4

Configure Environment Variables

أنشئ ملف .env في الدليل الجذر:
حدّث القيم باستخدام بيانات اعتماد Dodo Payments:
.env
لا ترفع ملف .env إلى نظام التحكم في الإصدارات مطلقًا. وهو مضمن بالفعل في .gitignore.
5

Add Your Products

حدّث internal/lib/products.go باستخدام معرّفات المنتجات الفعلية من Dodo Payments:
6

Run the Development Server

أو يدويًا:
افتح http://localhost:8000 لعرض صفحة الأسعار!
سترى صفحة أسعار ذات مظهر داكن، مع منتجاتك جاهزة للشراء.

بنية المشروع

نقاط نهاية API

يتضمن القالب نقاط النهاية المُعدة مسبقًا التالية:

التخصيص

تحديث معلومات المنتج

عدّل internal/lib/products.go لتعديل:
  • معرّفات المنتجات (من لوحة تحكم Dodo)
  • الأسعار
  • الميزات
  • الأوصاف

تعبئة بيانات العميل مسبقًا

في templates/index.html، استبدل بيانات العميل المضمّنة في الشيفرة ببيانات المستخدم الفعلية لديك:
في تطبيق الإنتاج، يمكنك حقن هذه القيم ديناميكيًا من نظام المصادقة لديك.

أحداث Webhook

يوضح القالب معالجة أحداث Webhook في internal/api/webhook.go. تشمل الأحداث المدعومة ما يلي: أضف منطق عملك داخل معالج Webhook من أجل:
  • تحديث أذونات المستخدمين في قاعدة بياناتك
  • إرسال رسائل بريد إلكتروني للتأكيد
  • توفير الوصول إلى المنتجات الرقمية
  • تتبع التحليلات والمقاييس

اختبار Webhooks محليًا

للتطوير المحلي، استخدم أدوات مثل ngrok لإتاحة خادمك المحلي عبر الإنترنت:
حدّث عنوان URL الخاص بـ Webhook في لوحة تحكم Dodo Payments:

النشر

البناء لبيئة الإنتاج

أو يدويًا:

النشر إلى Vercel

[ النشر باستخدام Vercel ](https://vercel.com/new/clone?repository-url=https://github.com/dodopayments/go-boilerplate)

Docker

أنشئ ملف Dockerfile:
أنشئ وشغّل:

اعتبارات الإنتاج

قبل النشر إلى بيئة الإنتاج:
  • بدّل DODO_PAYMENTS_ENVIRONMENT إلى live_mode
  • استخدم مفاتيح API الخاصة ببيئة الإنتاج من لوحة التحكم
  • حدّث عنوان URL الخاص بـ Webhook إلى نطاق الإنتاج لديك
  • فعّل HTTPS لجميع نقاط النهاية

استكشاف الأخطاء وإصلاحها

تأكد من تنزيل وحدات Go بشكل صحيح:
الأسباب الشائعة:
  • معرّف منتج غير صالح - تحقق من وجوده في لوحة تحكم Dodo
  • مفتاح API أو إعداد بيئة غير صحيح في .env
  • راجع سجلات الخادم للاطلاع على رسائل الخطأ التفصيلية
للاختبار المحلي، استخدم ngrok لإتاحة خادمك عبر الإنترنت:
حدّث عنوان URL الخاص بـ Webhook في لوحة تحكم Dodo إلى عنوان URL الخاص بـ ngrok. احرص على تحديث ملف .env بمفتاح التحقق الصحيح الخاص بـ Webhook.
تأكد من تشغيل الخادم من الدليل الجذر للمشروع، أو من تهيئة مسار القوالب بشكل صحيح في شيفرتك.

تعلّم المزيد

Go SDK

الوثائق الكاملة لـ Go SDK

Webhooks Documentation

تعرّف على جميع أحداث Webhook وأفضل الممارسات

Checkout Sessions

تعمّق في إعدادات جلسة Checkout

API Reference

وثائق API الكاملة لـ Dodo Payments

الدعم

هل تحتاج إلى مساعدة بشأن القالب الجاهز؟
آخر تعديل في ٣١ يوليو ٢٠٢٦