# Documentation


- **Getting started**
- [Introduction](/docs): The Octane Integration API lets your ERP, fleet or accounting system pull confirmed fuel transactions and receive them as signed webhooks. Start here.
- [Quickstart](/docs/quickstart): Get an API key from Octane, make your first request to the transactions endpoint and receive your first webhook, in about five minutes.
- [Authentication and access](/docs/authentication): Authenticate with a static API key in the X-API-Key header. Key format, what a key can access, and what each 401 and 403 code means.
- [Environments](/docs/environments): The production base URL is https://prod-app.octanetech-api.com/api/v1/integration. Staging keys start with oct_test_ and only work on staging.
- [Network and rate limits](/docs/network-and-rate-limits): Production keys accept requests only from your registered IP addresses, and each key is limited to 60 requests per minute. How to handle 403 and 429.
- Pull API
  - [List transactions](/docs/pull-api/transactions): GET /transactions returns your CONFIRMED and EXTERNAL fuel transactions for a date range of up to 31 days, 100 per page, with every field explained.
  - [Pagination](/docs/pull-api/pagination): The transactions endpoint pages with an opaque cursor. Pass next_cursor with the same filters until has_more is false. No skipped or duplicate records.
  - [Errors](/docs/pull-api/errors): Every error is a JSON object with a stable code, a message and a request_id. The full list of codes, what causes each and whether to retry.
- Webhooks
  - [Webhooks overview](/docs/webhooks): Octane sends a signed HTTPS POST to your endpoint when a transaction is confirmed or an external transaction is recorded. Endpoint requirements and event types.
  - [Events and payload](/docs/webhooks/events-and-payload): Webhook requests carry X-Octane-Event, X-Octane-Delivery and X-Octane-Signature headers and a JSON envelope with the full transaction object.
  - [Signature verification](/docs/webhooks/signature-verification): Verify X-Octane-Signature by computing HMAC-SHA256 over the timestamp, a dot and the raw body with your webhook secret. Samples in Node.js, Python, PHP, C# and Java.
  - [Delivery and retries](/docs/webhooks/delivery-and-retries): Webhook deliveries time out after 500 ms and are retried up to 3 times. De-duplicate on the delivery id. The webhook is disabled after 50 consecutive failures.

- **Resources**
- [Best practices](/docs/best-practices): Combine webhooks with scheduled Pull API syncs, upsert by transaction id, and re-query recent ranges to detect voided transactions.
- [Changelog](/docs/changelog): Changes to the Octane Integration API, newest first. The current API version is 2026-09-01.

# الوثائق


- **البداية**
- [مقدمة](/ar/docs): تتيح واجهة تكامل أوكتين لنظام تخطيط الموارد أو إدارة الأسطول أو المحاسبة لديك سحب معاملات الوقود المؤكدة واستقبالها كـ webhooks موقّعة. ابدأ من هنا.
- [البداية السريعة](/ar/docs/quickstart): احصل على مفتاح API من أوكتين، ونفّذ أول طلب إلى نقطة نهاية المعاملات، واستقبل أول webhook خلال نحو خمس دقائق.
- [المصادقة والوصول](/ar/docs/authentication): صادق باستخدام مفتاح API ثابت في ترويسة X-API-Key. صيغة المفتاح، وما يمكنه الوصول إليه، ومعنى كل رمز 401 و403.
- [البيئات](/ar/docs/environments): عنوان الإنتاج الأساسي هو https://prod-app.octanetech-api.com/api/v1/integration. تبدأ مفاتيح الاختبار بـ oct_test_ ولا تعمل إلا في بيئة الاختبار.
- [الشبكة وحدود المعدل](/ar/docs/network-and-rate-limits): تقبل مفاتيح الإنتاج الطلبات من عناوين IP المسجلة فقط، وكل مفتاح محدود بـ 60 طلبًا في الدقيقة. كيفية التعامل مع 403 و429.
- واجهة السحب
  - [قائمة المعاملات](/ar/docs/pull-api/transactions): يعيد GET /transactions معاملات الوقود بحالة CONFIRMED وEXTERNAL لنطاق تاريخ حتى 31 يومًا، 100 سجل في الصفحة، مع شرح كل حقل.
  - [ترقيم الصفحات](/ar/docs/pull-api/pagination): تُرقَّم نقطة نهاية المعاملات بمؤشر معتم. مرر next_cursor مع المرشحات نفسها حتى تصبح has_more خاطئة. لا سجلات متخطاة ولا مكررة.
  - [الأخطاء](/ar/docs/pull-api/errors): كل خطأ كائن JSON برمز ثابت ورسالة وrequest_id. القائمة الكاملة للرموز وسبب كل منها وهل تُعاد المحاولة.
- الويب هوك
  - [نظرة عامة على الويب هوك](/ar/docs/webhooks): ترسل أوكتين طلب POST موقّعًا عبر HTTPS إلى نقطة النهاية لديك عند تأكيد معاملة أو تسجيل معاملة خارجية. متطلبات نقطة النهاية وأنواع الأحداث.
  - [الأحداث والحمولة](/ar/docs/webhooks/events-and-payload): تحمل طلبات الويب هوك ترويسات X-Octane-Event وX-Octane-Delivery وX-Octane-Signature ومغلف JSON يحوي كائن المعاملة الكامل.
  - [التحقق من التوقيع](/ar/docs/webhooks/signature-verification): تحقق من X-Octane-Signature بحساب HMAC-SHA256 على الطابع الزمني ونقطة والجسم الخام بسر الويب هوك الخاص بك. أمثلة بلغات Node.js وPython وPHP وC# وJava.
  - [التسليم وإعادة المحاولة](/ar/docs/webhooks/delivery-and-retries): تنتهي مهلة تسليم الويب هوك بعد 500 ملّي ثانية ويُعاد حتى 3 مرات. امنع التكرار بمعرّف التسليم. يُعطَّل الويب هوك بعد 50 فشلًا متتاليًا.

- **موارد**
- [أفضل الممارسات](/ar/docs/best-practices): اجمع بين الويب هوك ومزامنات واجهة السحب المجدولة، ونفّذ upsert بمعرّف المعاملة، وأعد الاستعلام عن النطاقات الحديثة لاكتشاف المعاملات الملغاة.
- [سجل التغييرات](/ar/docs/changelog): التغييرات على واجهة تكامل أوكتين، الأحدث أولًا. إصدار الواجهة الحالي 2026-09-01.