Payment API

Create FTY payment links and Polygon mainnet payment requests.

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

FTY runs on Polygon 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: Polygon mainnet
Chain ID: 137
Currency: FTY
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",
  "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'
  })
});

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',
]);

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.

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.