Octane

معاملات الوقود، مباشرةً إلى نظامك.

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

ابدأ بدليل البداية السريعةتصفّح مرجع الواجهة

يتم تفعيل الوصول عبر مدير حسابك في أوكتين. لا يوجد تسجيل ذاتي.

سجل واحد، وطريقتان للحصول عليه

اطلب المعاملات حسب نطاق التاريخ عبر واجهة السحب، أو زوّد أوكتين بعنوان HTTPS واستقبل كل معاملة كـ webhook موقّع خلال ثوانٍ من تأكيدها. كائن المعاملة متطابق في الطريقتين، لذا يمكنك البدء بإحداهما وإضافة الأخرى لاحقًا.

مرجع واجهة السحبدليل الويب هوك
GET /transactions?from=…&to=…Pull API response
{
  "data": [{
    "id": 185432,
    "status": "CONFIRMED",
    "confirmed_at": "2026-09-20T09:00:02Z",
    "vehicle": { "number_plate": "ABC 1234", … },
    "fuel": { "liters": 18.5, "amount": 254.38 },
    "fees": { "total_amount": 255.435000 }
  }],
  "pagination": { "has_more": false }
}
POST https://erp.example.com/octaneWebhook delivery
X-Octane-Event: transaction.confirmed
X-Octane-Signature: t=1758358803,v1=5257a8…

{
  "type": "transaction.confirmed",
  "data": { "transaction": { "id": 185432, … } }
}

كيف تصل المعاملة إليك

  1. 1

    يتزوّد السائق بالوقود

    تُسجَّل المعاملة في المحطة مع عدد اللترات والمبلغ وقراءة العداد وصور المضخة.

  2. 2

    تؤكدها أوكتين

    تجتاز المعاملة فحوصات الاحتيال، ويُخصم المبلغ من رصيدك، وتصبح المعاملة نهائية.

  3. 3

    تستقبلها أنت

    خلال ثوانٍ كـ webhook موقّع، أو متى طلبتها حسب نطاق التاريخ عبر واجهة السحب. السجل نفسه في الحالتين.

ماذا تحتوي المعاملة

سجل واحد متطابق سواء سحبته أو استقبلته عبر webhook. تُقرَّب المبالغ إلى منزلتين عشريتين؛ أما الإجمالي المخصوم من رصيدك فيُحفظ بست منازل ليطابق كشف حسابك تمامًا.

اقرأ مرجع الحقول الكامل
المركبة
codenumber_platechassis_numberbrandmodeldepartment
السائق
idname
الوقود
typelitersprice_per_literamount
المحطة
nameprovideris_external
الإجماليات
total_feestotal_vattotal_amount
الأدلة
odometer_readingdistance_traveledfuel_consumptionimages

الأساسيات

المصادقة
مفتاح ثابت واحد لكل حساب، يُرسل في ترويسة X-API-Key
العنوان الأساسي
https://prod-app.octanetech-api.com/api/v1/integration
الحالات
معاملات CONFIRMED وEXTERNAL فقط
حدود السحب
حتى 31 يومًا لكل طلب، و100 سجل لكل صفحة، و60 طلبًا في الدقيقة
تسليم الويب هوك
موقّع بـ HMAC-SHA256، 3 محاولات، الرد خلال 500 ملّي ثانية
الشبكة
مفاتيح الإنتاج تعمل فقط من عناوين IP التي تسجّلها

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