الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

البداية السريعة للمدفوعات عبر الويب

البدء السريع لاستخدام SDK لمدفوعات الويب الخاصة بـ Square

  • نظرة عامة على SDK لمدفوعات الويب.
  • وثائق واجهة برمجة التطبيقات.

ابدء

ابدأ باستنساخ هذا المستودع. 

git clone https://github.com/square/web-payments-quickstart
cd web-payments-quickstart

قم بتثبيت Node.js الذي سيتضمن npm . يحتوي هذا المستودع على ملف .nvmrc إذا كنت تستخدم nvm لإدارة إصدارات العقدة الخاصة بك.

ثم، لتثبيت التبعيات، قم بتشغيل: 

npm install

قم بتشغيل خادم التطوير. 

npm run dev

وأخيرا، افتح http://localhost:3000.

أوراق اعتماد

قبل أن تتمكن من تلقي دفعة، ستحتاج إلى تكوين بيانات اعتماد المطور الخاصة بك والتي يمكن العثور عليها في لوحة تحكم المطور.

انسخ .env.example إلى .env.sandbox 

cp .env.example .env.sandbox

حدد SQUARE_ACCESS_TOKEN باستخدام رمز الوصول إلى Sandbox من لوحة تحكم المطور. 

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

أعد تشغيل الخادم الخاص بك لاستخدام هذه القيمة الجديدة.

تذكر: لا تقم بإضافة رموز الوصول الخاصة بك إلى git!

تطوير

يثبت

عند المساهمة في هذا المشروع، ستحتاج إلى استخدام إصدار Node كما هو محدد بواسطة .nvmrc . يمكنك استخدام nvm لتثبيت الإصدار الصحيح: 

nvm install $( cat .nvmrc )

اتبع تعليمات "البدء" أعلاه لتثبيت التبعيات والتحقق من بدء تشغيل الخادم المحلي بشكل صحيح.

اختبار

يمكنك تشغيل كافة الاختبارات والبنيات مثل CI باستخدام npm test .

فحص

يمكنك تشغيل جميع الـ linters باستخدام npm run lint .

ESLint

يقوم ESLint بتحليل الكود للعثور على المشكلات وإصلاحها. نحن نستخدم eslint-plugin-square للتكوين الجاهز. 

npm run lint:eslint
إصلاح التحذيرات والأخطاء تلقائيا

يمكن لـ ESLint أحيانًا إصلاح التحذيرات والأخطاء تلقائيًا لك باستخدام خيار --fix. 

npm run lint:eslint --fix

أجمل

Prettier هو منسق كود عنيد. نستخدم @square/prettier-config لتلك الآراء. 

npm run lint:prettier
إصلاح مشاكل نمط التعليمات البرمجية

إذا تلقيت تحذيرًا مثل، بعد تشغيل npm run lint:prettier ، "تم العثور على مشكلات في نمط التعليمات البرمجية في الملف (الملفات) أعلاه. هل نسيت تشغيل Prettier؟"، فيمكنك مطالبة Prettier بإصلاحها. 

npm run lint:prettier:fix

التكامل المستمر

يتم استخدام إجراءات GitHub لسير عمل CI/CD الخاص بنا. راجع .github/workflows للحصول على التفاصيل.

رخصة

حقوق الطبع والنشر لعام 2021 محفوظة لشركة Square, Inc.

مرخص بموجب ترخيص Apache، الإصدار 2.0 ("الترخيص")؛ لا يجوز لك استخدام هذا الملف إلا وفقًا للترخيص. يمكنك الحصول على نسخة من الترخيص على

http://www.apache.org/licenses/LICENSE-2.0

ما لم يكن ذلك مطلوبًا بموجب القانون المعمول به أو تم الاتفاق عليه كتابيًا، يتم توزيع البرامج الموزعة بموجب الترخيص على أساس "كما هي"، دون ضمانات أو شروط من أي نوع، سواء كانت صريحة أو ضمنية. راجع الترخيص لمعرفة الأذونات والقيود التي تحكم اللغة المحددة بموجب الترخيص.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل