API ya Malipo

Create malipo links and FTY settlement requests.

Create malipo 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 pochi. Hakuna ahadi ya uwekezaji, hakuna mavuno, hakuna staking, hakuna ukopeshaji, and no faida iliyohakikishwa.

API za Wafanyabiashara

Unda ombi: POST /api/merchant/payment-requests
Hali ya mfanyabiashara: GET /api/merchant/payment-requests/{reference}/status
Hali ya umma: 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

Mtandao: FTY on Ethereum mainnet
Kitambulisho cha Chain: 137
Settlement currency: FTY
Customer preferences: FTY, ETH, BTC, USDC, USDT
Malipo: Furety Treasury Safe or merchant-configured approved pochi
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',
]);

Kanuni za Usalama

The API never asks for funguo binafsi, 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, na USDT. FTY remains the settlement and service utility currency unless a supported malipo 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 matumizi malipo currency. Furety does not offer staking, lending, yield, faida iliyohakikishwas, or exchange-price promises.