الانتقال إلى الوثائق
SparkGlimDeveloper
مركز التكامل بمساعدة الذكاء الاصطناعي
SparkGlimSparkGlim للمطوّرين
ابحث في جميع الوثائق

جرّب موضوعًا بلغتك أو مسار API دقيقًا.

    أدلة التكامل

    اربط تبرعًا حقيقيًا بالدفع المركزي

    اجمع الحقول المهيأة واترك العملة والرسوم والمساهمة المؤكدة للخادم.

    قبل البدء

    • حملة تبرع عامة حقيقية مفتوحة للمساهمات.
    • عملة الحملة وحدود المبلغ والحقول والمجاميع العامة المسموحة.
    • اختبار مصرح وعميل Web محمي أو تكامل منظمة معتمد بصورة منفصلة.
    01

    اقرأ القضية ومتطلبات التبرع

    اعرض الحملة والمستفيد العام. يستخدم المبلغ عملة البيع الحقيقية؛ احترم الحقول المناسبة وخيار إخفاء الهوية.

    لا تختلق أهدافًا أو مجاميع ولا تكشف متبرعين خاصين ولا تستبدل عملة العرض. يتحقق Server من المبلغ والرسوم.

    02

    احتفظ بالحماية على مسار Web

    تمر POST /api/public/donate عبر fetchPublicFlow("/donate", ...) لتجهيز السياق والمحاولة الثابتة. يرفض Server السياق المفقود ويطبق الحماية.

    لا يستبدل سكربت أو ملحق خارجي ذلك ببصمات مزيفة. استخدم التكامل المعتمد أو صفحة الحملة؛ الأداة ليست حزمة متصفح منشورة.

    03

    افتح الدفع الذي يديره الخادم

    لا يرسل المثال غير النشط شيئًا عند عرض الوثائق. استدعه من نموذج متحقق وباختبار مصرح واحتفظ بالمحاولة عند الغموض.

    افتح authorization_url على checkout.sparkglim.net. يعيد Checkout الزائر ويسجل Server التبرعات. دون تحقق دفع أو استطلاع أو إجمالي متفائل أو تأكيد مختلق في المتصفح.

    طلب توضيحي بقيم بديلة
    typescript
    'use client';
    import { fetchPublicFlow } from '@/lib/server-backend/public-api';
    type Input = { campaign_id: string; amount: number; phone_number?: string; email?: string; donor_name?: string; anonymous?: boolean; custom_data?: Record<string, unknown>; client_attempt_id: string; return_path: string };
    let requestStarted = false;
    export async function initializeApprovedTest(input: Input, approvedTest: boolean) {
      if (!approvedTest || requestStarted) return null;
      requestStarted = true;
        const response = await fetchPublicFlow('/donate', {
          method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(input)
        });
        const result = await response.json();
        if (!response.ok || result.success !== true) throw new Error(result.error || 'Checkout unavailable');
        if (typeof result.data?.authorization_url !== 'string') throw new Error('No paid checkout URL returned');
        const target = new URL(result.data.authorization_url);
        if (target.origin !== 'https://checkout.sparkglim.net' || target.username || target.password) throw new Error('Invalid checkout URL');
        window.location.assign(target.href);
        return target.href;
    }

    تحقق من تكاملك

    • اختبر المبلغ والتواصل وإخفاء الهوية بسجلات مصرح بها.
    • احفظ العملة وسرية المجاميع وراجع العودة دون تبرع حقيقي.