Payment API

Create payment links and FTY settlement requests.

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

FTY runs on FTY on Ethereum mainnet. Payments settle to the Furety Treasury Safe or merchant-configured approved wallet. No investment promise, no yield, no staking, no lending, and no guaranteed return.

Merchant APIs

Create request: POST /api/merchant/payment-requests
Merchant status: GET /api/merchant/payment-requests/{reference}/status
Public status: GET /api/payments/{reference}/status
Submit tx hash: POST /api/merchant/payment-requests/{reference}/confirmations
Webhook endpoint: POST /api/merchant/webhook-endpoints
Webhook event: POST /api/merchant/webhook-events

Payment Metadata

Network: FTY on Ethereum mainnet
Chain ID: 137
Settlement currency: FTY
Customer preferences: FTY, ETH, BTC, USDC, USDT
Settlement: Furety Treasury Safe or merchant-configured approved wallet
Auth: X-Furety-Api-Key

cURL Example

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 Example

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 Example

$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, and USDT. FTY remains the settlement and service utility currency unless a supported payment processor flow is explicitly enabled.

API keys are rate-limit-ready and restricted to approved verified merchants. Webhook signing values must stay in Google Secret Manager by reference only.

FTY is a utility payment currency. Furety does not offer staking, lending, yield, guaranteed returns, or exchange-price promises.