Payment API

Create ادائیگی links and FTY settlement requests.

Create ادائیگی requests with reviewed API-key access to checkout links, QR payloads, customer currency preferences, status records, webhook events, and Safe treasury settlement metadata.

FTY FTY on Ethereum mainnet پر چلتا ہے۔ Payments settle ہوتے ہیں the Furety Treasury Safe or merchant-configured approved wallet۔ کوئی investment promise، yield، staking، lending، یا guaranteed return نہیں۔

مرچنٹ APIs

درخواست بنائیں: POST /api/merchant/payment-requests
مرچنٹ اسٹیٹس: GET /api/merchant/payment-requests/{reference}/status
Public status: GET /api/payments/{reference}/status
tx hash submit کریں: POST /api/merchant/payment-requests/{reference}/confirmations
Webhook endpoint: POST /api/merchant/webhook-endpoints
Webhook event: POST /api/merchant/webhook-events

Payment Metadata

نیٹ ورک: FTY on Ethereum mainnet
Chain ID: 137
Settlement currency: FTY
Customer preferences: FTY, ETH, BTC, USDC, USDT
سیٹلمنٹ: Furety Treasury Safe or merchant-configured approved wallet
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',
]);

Safety Rules

The API never asks for private keys, seed phrases, card details, bank credentials, or raw webhook signing secrets. Raw API keys are shown only once at creation and stored as hashes.

preferred_customer_currency accepts FTY, ETH, BTC, USDC، اور USDT. FTY remains the settlement and service utility currency unless a supported ادائیگی processor flow is explicitly enabled.

API keys rate-limit کے لیے تیار ہیں اور صرف منظور شدہ verified merchants تک محدود ہیں۔ Webhook signing values صرف reference کے طور پر Google Secret Manager میں رہنی چاہئیں۔

FTY ایک utility payment currency ہے۔ Furety پیش نہیں کرتا staking, lending, yield, guaranteed returns, or exchange-price promises۔