الإعلان عن واجهة برمجة تطبيقات بطاقات الهدايا
تدير العديد من الشركات برامج بطاقات الهدايا كوسيلة لجذب عملاء جدد وزيادة المبيعات. باستخدام بطاقات هدايا سكوير، نحن نمكن البائعين من إطلاق برنامج إهداء كامل ببطاقات الهدايا عبر الإنترنت والمادية التي تتكامل بسلاسة في Square Dashboard ، ودليل العملاء، ونظام نقاط البيع.
اليوم، يسعدنا أن نعلن أنه يمكن للمطورين الآن توسيع إمكانيات Square Gift Card لتشمل تطبيقاتهم باستخدام واجهة برمجة تطبيقات بطاقات الهدايا – وهي متاحة الآن بشكل عام. يتيح التكامل مع واجهة برمجة تطبيقات بطاقات الهدايا للمطورين تقديم خيارات دفع أكثر مرونة وخدمة البائعين الذين يرغبون في توسيع برامج بطاقات الهدايا الخاصة بهم إلى قنوات جديدة بشكل أفضل. توفر واجهة برمجة التطبيقات (API) نقاط نهاية لإنشاء وإدارة وربط أو إلغاء ربط العملاء ببطاقات الهدايا. بالإضافة إلى ذلك، يمكنك أيضًا تنشيط بطاقة الهدايا وتحميلها واستردادها وتلقي إشعارات الويب هوك حول أحداث بطاقة الهدايا.
إليك المزيد مما يمكنك فعله باستخدام واجهة برمجة تطبيقات بطاقات الهدايا:
دمج بطاقات هدايا سكوير في أي تطبيق. سواء كنت تنشئ تطبيقًا للتجارة الإلكترونية أو تطبيقًا مخصصًا للجوّال أو أي تطبيق آخر، يمكنك تقديم بطاقات هدايا سكوير على أي نظام أساسي تقوم بإنشائه لخدمة البائعين بشكل أفضل عبر قنوات متعددة.
تمكين البائعين من بيع بطاقات الهدايا واسترداد قيمتها عبر القنوات باستخدام أرقام حسابات بطاقات الهدايا المخصصة. يمكنك الآن إنشاء رموز بطاقات هدايا مخصصة ومطابقتها عبر حسابات التجار في Square ، مما يساعد البائعين على بيع بطاقات الهدايا واستردادها عبر بائعين متعددين داخل نفس المؤسسة وعلى أي قناة.
تصميم العلامة التجارية لبطاقات الهدايا. يمكنك إنشاء تدفقات الدفع أو الاسترداد الخاصة بك وتخصيص تجربة شراء بطاقة الهدايا لتتناسب مع شكل ومظهر أي عمل تجاري.
مزامنة بيانات بطاقة الهدايا في Square Dashboard. يضمن التكامل تدفق جميع بيانات بطاقات الهدايا بسلاسة إلى حسابات البائعين Square ، مما يسمح بإدارة البيانات المبسطة والمركزية.
تستخدم SimpleTix ، وهي منصة لتسجيل الأحداث وإصدار التذاكر ، واجهة برمجة تطبيقات بطاقات الهدايا منذ إطلاقها في مرحلة تجريبية.
كيف تعمل واجهة برمجة تطبيقات بطاقات الهدايا
باستخدام Gift Cards API، يمكن للمطورين إنشاء بطاقات هدايا واسترداد بطاقات الهدايا وتنشيط بطاقات الهدايا واسترداد بطاقات الهدايا لعملية شراء.
للبدء، ستتصل أولاً بنقطة نهاية CreateGiftCard لإنشاء بطاقة هدايا:
تتيح لك نقطة نهاية CreateGiftCard أيضًا تحديد رقم حساب بطاقة هدايا مخصص (GAN) عند إنشاء بطاقة هدايا. يجب أن تحتوي بطاقات الهدايا التي تم إنشاؤها باستخدام GAN مخصص gan_sourceعلى OTHER.
بعد ذلك، يمكنك الاستفادة من التكامل مع Orders API و Payments APIs لتنشيط بطاقة الهدايا. انظر هنا للحصول على التسلسل الكامل للخطوات. بمجرد اكتمال الطلب، يمكنك تنشيط بطاقة الهدايا عن طريق الاتصال بنقطة CreateGiftCardActivityالنهاية بـ order_idو line_item_uidالذي تم إرجاعه في CreateOrderالرد.
تدعم نقطة نهاية CreateGiftCardActivity أيضًا إنشاء أنواع مختلفة من الأنشطة، مثل LOAD، REDEEMوما إلى ذلك CLEAR_BALANCE. IMPORTبالإضافة إلى ذلك، تم دمج واجهة برمجة تطبيقات بطاقات الهدايا مع واجهة برمجة تطبيقات الالعملاء،ما يسمح للمطورين باستخدام نقطة نهاية LinkGiftCardToCustomer من أجل الارتباط customer_idsببطاقات الهدايا.
لاسترداد بطاقة الهدايا لعملية شراء، يمكنك استخدام Payments API لأخذ دفعة ببطاقة الهدايا. يمكن أن يحدد طلب source_idCreatePayment معرّف بطاقة الهدايا. التسلسل الكامل للخطوات موضح هنا.
أخيرًا، يتم نشر خطافات الويب الخاصة بواجهة برمجة تطبيقات بطاقات الهدايا كلما تم إنشاء بطاقات الهدايا وأنشطة بطاقات الهدايا أو تحديثها.
ابدأ البناء
تتوفر واجهة برمجة تطبيقات بطاقات الهدايا بشكل عام للمطورين والشركاء في الولايات المتحدة وكندا والمملكة المتحدة وأيرلندا وأستراليا واليابان وفرنسا وإسبانيا. تختلف الأسعار للبائعين بالنسبة لبطاقات الهدايا الرقمية والمادية، وكذلك حسب المنطقة. لبدء البناء، تحقق من وثائق المطور والمرجع الفني. كما هو الحال دائمًا، يرجى مشاركة ملاحظاتك في قناة مجتمع Slack أو منتديات Square Developer . إذا كنت ترغب في مواكبة بقية المحتوى الخاص بنا بنا،كد من متابعة هذه المدونة وحساب Twitter الخاص بنا.
المصدر: developer
شاهد المزيد:
