Fiatside
fr

Developers

البيانات المرجعية والترقيم

كتالوجات قنوات الدفع والأصول والبلدان هي نفس المصدر الذي يغذي الموقع. تحمل الحدود والتأخيرات والرسوم ومخططات الحقول — بما يكفي لإنشاء نموذج الدفع الخاص بك بدلاً من برمجته بلدًا بلد.

تكرار التحديث

تتغير هذه البيانات نادرًا، لكنها تتغير: حد قناة، موعد قطع، فتح بلد. حدّثها يوميًا على الأقل، ولا تجمدها في الكود الخاص بك. يحمل كل إدخال تاريخ آخر تحقق يدوي: بعد ستة أشهر، اعتبره مستحقًا للفحص.

01

الترقيم

ترقيم بالمؤشر، وليس بإزاحات رقمية. الإزاحة تتخطى أو تكرر العناصر بمجرد أن تتحرك القائمة بين صفحتين؛ المؤشر يشير إلى موضع ثابت.

الطلبhttp
GET /api/v1/rails?limit=50&cursor=cJ0xNzg4MzU2OTgx
الاستجابةjson
{
  "data": [ /* … */ ],
  "next_cursor": "cJ0xNzg4MzU3MTEy"
}
  • الحد الافتراضي هو 50، والحد الأقصى 100. أي قيمة أكبر تُقص إلى الحد الأقصى بدلاً من رفضها.
  • next_cursor يكون فارغًا في الصفحة الأخيرة. إنها إشارة النهاية الوحيدة: لا تستنتج النهاية من صفحة قصيرة.
  • المؤشر غير شفاف وليس له عمر مضمون. لا تخزنه كمعرف دائم، ولا تصنع واحدًا بنفسك.
  • الترتيب مستقر ضمن تشغيل ترقيم واحد. عنصر أُضيف أثناء تصفحك يظهر في تشغيلك الكامل التالي، وليس في منتصف التشغيل الحالي.
GET/api/v1/railsPublished contract, not open

قائمة طرق الدفع

كتالوج قنوات الدفع مع العملة والبلدان المخدومة وتأخيرات p50 و p95 وقواعد أيام العمل ووقت القطع وحدود كل عملية بالوحدات الثانوية والرسوم ومخطط حقل المستفيد. هذا المخطط هو ما يتيح لك إنشاء نموذج الدفع بدلاً من برمجته بلدًا ببلد.

المصادقة: Authorization: Bearer … انظر المصادقة

المعلمات

المعلمات
الحقلالنوعالوصف
countrystringمرشح ISO 3166-1 alpha-2.
currencystringمرشح ISO 4217.
phasestringlive أو beta أو planned أو never.
limitintegerحجم الصفحة، من 1 إلى 100، الافتراضي 50.
cursorstringمؤشر غير شفاف يتم إرجاعه بواسطة الاستدعاء السابق.
الطلبbash
curl -sS 'https://fiatside.com/api/v1/rails?country=BR' \
  -H 'Authorization: Bearer sk_live_...'
الاستجابة — العقد المنشورjson
{
  "data": [
    {
      "id": "br_pix",
      "slug": "pix",
      "name": "PIX",
      "kind": "instant_bank",
      "currency": "BRL",
      "countries": ["BR"],
      "phase": "live",
      "settlement": { "p50Minutes": 1, "p95Minutes": 10, "businessDaysOnly": false },
      "limits": { "minMinor": 1000, "maxMinor": 5000000, "decimals": 2 },
      "fees": { "fixedMinor": 0, "bps": 0 },
      "fields": [
        { "name": "pixKeyType", "type": "select", "required": true },
        { "name": "pixKey", "type": "text", "required": true, "maxLength": 77 },
        { "name": "taxId", "type": "text", "required": true, "pattern": "^[0-9]{11}$" }
      ],
      "verifiedAt": "2026-09-02"
    }
  ],
  "next_cursor": null
}
  • يتم إرجاع القناة المغلقة بمرحلتها وسببها، ولا تتم إزالتها من القائمة. التكامل الذي لا يستطيع رؤية سبب اختفاء قناة يطلب دعمه الخاص.

الأخطاء المحتملة: unauthorized, invalid_request. الفهرس الكامل

GET/api/v1/assetsPublished contract, not open

قائمة الأصول المقبولة

الأصول المقبولة للإيداع، مع الكسور العشرية للوحدة الأساسية والشبكات والحد الأدنى للإيداع ومدة قفل السعر، وحيثما كان ذلك مناسبًا، سبب عدم تقديم الأصل.

المصادقة: Authorization: Bearer … انظر المصادقة

المعلمات

المعلمات
الحقلالنوعالوصف
networkstringيُرجع فقط الأصول المتاحة على تلك الشبكة.
الطلبbash
curl -sS 'https://fiatside.com/api/v1/assets?network=tron' \
  -H 'Authorization: Bearer sk_live_...'
الاستجابة — العقد المنشورjson
{
  "data": [
    {
      "id": "usdt",
      "ticker": "USDT",
      "name": "Tether",
      "decimals": 6,
      "networks": ["tron", "ethereum", "bsc", "solana", "polygon", "arbitrum"],
      "stablecoin": true,
      "quoteLockSeconds": 1800,
      "minDepositBase": "20000000",
      "phase": "live"
    }
  ],
  "next_cursor": null
}
  • يتم التعبير عن minDepositBase بالوحدات الأساسية (20000000 = 20 USDT بستة منازل عشرية). تحت هذا الحد، تستهلك تكلفة الشبكة معظم العملية.

الأخطاء المحتملة: unauthorized. الفهرس الكامل

GET/api/v1/countriesPublished contract, not open

قائمة البلدان

البلدان المخدومة والبلدان قيد التحضير والبلدان المرفوضة. يتم إرجاع البلد المرفوض مع سببه: عقوبات دولية، أو تدابير تقييدية، أو خطر غسيل أموال غير مقبول.

المصادقة: Authorization: Bearer … انظر المصادقة

المعلمات

المعلمات
الحقلالنوعالوصف
statusstringopen أو coming أو restricted.
الطلبbash
curl -sS 'https://fiatside.com/api/v1/countries?status=open' \
  -H 'Authorization: Bearer sk_live_...'
الاستجابة — العقد المنشورjson
{
  "data": [
    { "code": "BR", "name": "Brasil", "currency": "BRL", "status": "open", "rails": ["br_pix", "paypal", "wise", "swift"] },
    { "code": "IR", "name": "Iran",   "currency": null,  "status": "restricted", "reason": "international_sanctions" }
  ],
  "next_cursor": null
}

الأخطاء المحتملة: unauthorized. الفهرس الكامل

02

مخطط حقول المستفيد

تصف كل قناة الحقول التي تتطلبها، مع نمط التحقق والتطبيع ونص المساعدة. هذا ما يتيح لك إنشاء نموذج صحيح لبلد لم تدمجه من قبل.

حقل مخطط واحدjson
{
  "name": "iban",
  "label": { "fr": "IBAN", "en": "IBAN" },
  "type": "iban",
  "required": true,
  "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$",
  "normalize": "upper",
  "help": {
    "fr": "Sans espaces. Nous verifions la cle de controle avant de valider la commande.",
    "en": "No spaces. We validate the checksum before confirming your order."
  }
}

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