API پرداخت

Create پرداخت links and FTY تسویه requests.

Create پرداخت requests with reviewed API-key access to checkout links, QR payloads, customer currency preferences, وضعیت records, webhook events, and Safe خزانه تسویه metadata.

FTY روی شبکه اصلی FTY on Ethereum اجرا می‌شود. Payments settle به خزانه Safe فُرتی یا کیف پول تأییدشده و پیکربندی‌شده پذیرنده. بدون وعده سرمایه‌گذاری، بدون بازده، بدون staking، بدون وام‌دهی، و بدون بازده تضمینی.

APIهای پذیرندگان

ایجاد درخواست: POST /api/merchant/payment-requests
وضعیت پذیرنده: GET /api/merchant/payment-requests/{reference}/status
وضعیت عمومی: GET /api/payments/{reference}/status
ارسال هش تراکنش: POST /api/merchant/payment-requests/{reference}/confirmations
Endpoint وب‌هوک: POST /api/merchant/webhook-endpoints
رویداد وب‌هوک: POST /api/merchant/webhook-events

فراداده پرداخت

شبکه: شبکه اصلی FTY on Ethereum
شناسه زنجیره: 137
Settlement currency: 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 signing اسرار. Raw کلیدهای API هستند shown فقط once at ایجاد و stored به‌عنوان hashes.

preferred_customer_currency accepts FTY, ETH, BTC, USDC، و USDT. FTY remains the تسویه and خدمت منفعت currency unless a supported پرداخت processor flow is explicitly enabled.

کلیدهای API برای محدودسازی نرخ آماده‌اند و فقط به پذیرندگان تأییدشده و معتبر محدود می‌شوند. مقادیر امضای وب‌هوک باید فقط به‌صورت ارجاع در Google Secret Manager باقی بمانند.

FTY یک منفعت پرداخت ارز. Furety می‌کند نه پیشنهاد staking، lending، yield، تضمینی returns، یا exchange-price promises.