واجهة الدفع البرمجية

Create دفع روابط و FTY تسوية طلبات.

Create دفع طلبات مع مراجع API-key وصول إلى الدفع روابط, QR حزم بيانات, عميل عملة preferences, حالة سجلات, ويب هوك events, و Safe خزينة تسوية بيانات وصفية.

تعمل FTY على شبكة FTY on Ethereum الرئيسية. وتتم تسوية المدفوعات إلى خزينة فُراتيّ Safe أو إلى محفظة تاجر معتمدة ومهيأة مسبقاً. لا يوجد وعد استثماري، ولا عائد، ولا تخزين بعائد، ولا إقراض، ولا عائد مضمون.

واجهات التجار البرمجية

إنشاء طلب: POST /api/merchant/payment-requests
حالة التاجر: GET /api/merchant/payment-requests/{reference}/status
الحالة العامة: GET /api/payments/{reference}/status
إرسال تجزئة المعاملة: POST /api/merchant/payment-requests/{reference}/confirmations
نقطة webhook: POST /api/merchant/webhook-endpoints
حدث webhook: POST /api/merchant/webhook-events

بيانات الدفع

الشبكة: شبكة FTY على Ethereum الرئيسية
رقم السلسلة: 137
Settlement عملة: FTY
Customer preferences: FTY, ETH, BTC, USDC, USDT
التسوية: خزينة فُراتيّ Safe أو محفظة تاجر معتمدة ومهيأة مسبقاً
Auth: X-Furety-Api-Key

مثال cURL

POST /api/merchant/payment-requests
X-Furety-Api-Key: fpk_...

{
  "title": "Merchant checkout",
  "fty_amount": "25.5",
  "preferred_customer_currency": "USDC",
  "customer_email": "customer@example.com"
}

مثال JavaScript

await fetch('/api/merchant/payment-requests', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Furety-Api-Key': merchantApiKey
  },
  body: JSON.stringify({
    title: 'Merchant checkout',
    fty_amount: '25.5',
    preferred_customer_currency: 'USDC'
  })
});

مثال PHP

$response = Http::withHeaders([
    'X-Furety-Api-Key' => $merchantApiKey,
])->post('https://furety.com/api/merchant/payment-requests', [
    'title' => 'Merchant checkout',
    'fty_amount' => '25.5',
    'preferred_customer_currency' => 'USDC',
]);

قواعد السلامة

لا تطلب API أبداً مفاتيح خاصة أو عبارات استرداد أو بيانات بطاقات أو بيانات مصرفية أو أسرار توقيع webhook الخام. وتُعرض مفاتيح API الخام مرة واحدة فقط عند الإنشاء ثم تُخزن كبصمات مشفرة.

preferred_customer_currency accepts FTY, ETH, BTC, USDC، و USDT. FTY remains الـ تسوية و خدمة منفعة عملة unless a supported دفع processor مسار هو explicitly enabled.

مفاتيح API مهيأة لتطبيق حدود الاستخدام ومقصورة على التجار المعتمدين والموثقين. ويجب أن تبقى قيم توقيع webhook داخل Google Secret Manager كمراجع فقط.

FTY عملة منفعة للمدفوعات. ولا تقدم فُراتيّ تخزيناً بعائد أو إقراضاً أو عائداً أو عوائد مضمونة أو وعوداً بسعر التداول.