Coin Moebius
كل المزودين

Authorize.Net

يدفع المشترون عبر حساب Authorize.Net الخاص بك، ولا يحتفظ Coin Moebius بالمال أبداً.

ما تحتاجه

الحقلما يفعله
API Login IDيعرّف حسابك في نداءات الواجهة البرمجية. مقترَن بـ Transaction Key.
Transaction Keyالنصف السري من مصادقة الواجهة البرمجية. مع Login ID، يسكّ كل نموذج دفع. سري.
Signature Keyيؤكّد أن webhook أتى فعلاً من Authorize.Net. منفصل عن Transaction Key. سري.
عنوان النجاح / عنوان الإلغاءحيث يصل المشتري بعد الدفع أو التراجع.

يسافر API Login ID وTransaction Key معاً دائماً. وSignature Key مستقل.

لماذا نطلب كل حقل

API Login ID

يسمّي حسابك في نداءات الواجهة البرمجية. ويعمل فقط حين يُقرَن بـ Transaction Key.

Transaction Key

السر الذي يثبت أن طلب واجهة برمجية لك. مع API Login ID، يتيح لنا بناء نموذج الدفع المستضاف، فتجري الخصمة عبر حسابك.

Signature Key

يثبت أن webhook وارداً من Authorize.Net فعلاً، فلا يستطيع أحد تزوير حدث "مدفوع". وهو قيمة منفصلة عن Transaction Key.

عنوان النجاح والإلغاء

إعدادات بسيطة: حيث يصل المشتري بعد الدفع أو التراجع. ليست سرية.

الإعداد

  1. أنشئ حساب sandbox مجانياً (بلا دفع)

    لا تحتاج إلى حساب تاجر مدفوع للاختبار. يقدّم Authorize.Net sandbox مجانياً يحاكي الإنتاج، بلا بطاقة ائتمان مطلوبة.

    1. اذهب إلى developer.authorize.net/hello_world/sandbox.html وسجّل لحساب sandbox. استخدم ذلك الرابط، لا صفحة التسجيل الرئيسية أو صفحة الأسعار (وهي طلب الحساب الحي المدفوع).
    2. سجّل الدخول إلى Merchant Interface في الـ sandbox على sandbox.authorize.net.

    نظام التوقيع مطابق للإنتاج، فأي شيء تتحقق منه في الـ sandbox يتصرف بالطريقة نفسها في الوضع الحي.

  2. انسخ بيانات اعتمادك الثلاث

    المسار نفسه في الـ sandbox والحي: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.

    • يُعرَض API Login ID في الأعلى.
    • Transaction Key: اختر "New Transaction Key"، وأكّد، وانسخه فوراً (يُعرَض مرة واحدة).
    • Signature Key: اختر "New Signature Key"، وأكّد، وانسخه على الفور.
    Account → Settings → Security Settings → API Credentials and Keys
  3. أضف الـ webhook
    1. Account → Settings → Business Settings → Webhooks، أضف نقطة نهاية.
    2. اضبط عنوان نقطة النهاية على عنوان webhook مشروعك (أدناه).
    3. اشترك بالأحداث. للمدفوعات لمرة واحدة: net.authorize.payment.authorization.created، وauthcapture.created، وcapture.created، وpriorAuthCapture.created، وrefund.created، وvoid.created، وأحداث fraud.* (held، وapproved، وdeclined). وللاشتراكات (Automated Recurring Billing): أحداث net.authorize.customer.subscription.*. وتصل التجديدات كـ authcapture.created، وهي مغطاة بالفعل. الأحداث الإضافية غير ضارة.
    4. احفظ. يوقّع Authorize.Net كل تسليم بـ Signature Key الخاص بك.
    https://api.coinmoebius.com/webhook/authorizenet/<your project id>
    Account → Settings → Business Settings → Webhooks

    يسجّل Coin Moebius كل معرّف حدث مرة واحدة ويتجاهل التكرارات، فتُعالَج الـ webhooks المعادة نيابة عنك.

  4. اختبر ببطاقات الـ sandbox

    بطاقات الـ sandbox لا تخصم من بطاقة حقيقية أبداً. استخدم أي تاريخ انتهاء مستقبلي (مثلاً 12/2030) وأي CVV (3 أرقام، أو 4 لـ American Express).

    الشبكةالبطاقة
    Visa4111111111111111
    Mastercard5424000000000015
    American Express370000000000002
    Discover6011000000000012
  5. اربط في لوحة التحكم

    إضافة مزود → Authorize.Net. أدخل عنوان النجاح، وعنوان الإلغاء، ومجموعة الحي (API Login ID، وTransaction Key، وSignature Key). أضف مجموعة Sandbox الاختيارية للاختبار. مجموعة Sandbox كلٌّ أو لا شيء: الحقول الثلاثة، أو لا شيء. ويُفحَص الحي والـ sandbox على حدة.

بعد أن تربط

أجرِ دفعة اختبار واحدة قبل الإطلاق:

  1. أنشئ منتجاً واضبط بيئته على Testing. يشغّل ذلك المنتج على بيانات اعتماد الـ sandbox الخاصة بك، فيمكنك إجراء طلب كامل دون تحريك مال. (إن تخطّيت مجموعة الـ sandbox، فإن منتج Testing يعود إلى الحي، فأضِفها أولاً.)
  2. ضع زر الشراء على صفحة (ملف HTML محلي يعمل) موجَّهاً إلى مشروعك.
  3. أتمِم الدفع ببطاقة اختبار sandbox من أعلاه.
  4. افتح تبويب المعاملات. يظهر صف جديد، موسوم Testing. وحين تبلغ حالته succeeded، تعمل بيانات اعتمادك والـ webhook من البداية إلى النهاية.

بدّل بيئة المنتج إلى Live حين تكون جاهزاً للمدفوعات الحقيقية.

حل المشكلات

ابدأ بالتحقق. في لوحة التحكم، انقر تحقق (أو تحقق من بيانات اعتماد الاختبار لمجموعة الـ sandbox) لفحص API Login ID وTransaction Key.

يفشل التحقق.

يجب أن يكون API Login ID وTransaction Key الزوج من الحساب نفسه (الحي أو الـ sandbox). أعِد نسخ كليهما.

يفشل التحقق من التوقيع.

Signature Key قيمة مختلفة عن Transaction Key. انسخ Signature Key من الشاشة نفسها. النظام مطابق في الـ sandbox والحي.

تكتمل الدفعة لكن الطلب يبقى معلّقاً.

أكّد أن عنوان الـ webhook يطابق بالضبط وأنك اشتركت بأحداث الدفع.

منتج اختبار خصم من بطاقة حية.

منتج موسوم كاختبار يعود إلى بيانات اعتمادك الحية حين لا تكون مجموعة sandbox كاملة مهيَّأة. أضِف الحقول الثلاثة للـ sandbox، أو أزِل وسم الاختبار عن المنتج.

أكّده من البداية إلى النهاية.

لا يرسل Authorize.Net ping إلا لـ webhooks غير النشطة: اضبط نقطة النهاية غير نشطة، وأرسل ping، ثم أعِد تنشيطها، وراقب تحديث الطلب.

جيد أن تعرف

الرموز قصيرة العمر. رمز النموذج المستضاف يدوم نحو 15 دقيقة. نسكّ رمزاً جديداً لكل عملية دفع.

العملة. Authorize.Net في الأساس بوابة أمريكية بالدولار. ودعم العملات غير الدولار يعتمد على اتفاق معالِجك.

تدوير المفاتيح. ولّد Transaction Key أو Signature Key جديداً في أي وقت، ثم الصقه. تبقى الحقول السرية فارغة عند التعديل.

أسئلة؟ Join our Discord

جاهز لربط مزود؟

اختر المزودين الذين تستخدمهم بالفعل. يدفع المشترون عبر حساباتك، وتحتفظ بزر شراء واحد.

اطّلع على الأسعارالعودة إلى التوثيق