API na biyan kuɗi

Create biyan kuɗi links and FTY settlement buƙatu.

Create biyan kuɗi buƙatu with reviewed API-key access to checkout links, QR payloads, customer currency preferences, matsayi records, webhook events, and Safe taska settlement metadata.

FTY runs on FTY on Ethereum mainnet. Payments settle to the Furety Treasury Safe ko walat da ɗan kasuwa ya saita kuma aka amince da shi. Babu alƙawarin zuba jari, babu riba, babu staking, babu lending, da babu dawowa tabbatacciya.

API na yan kasuwa

Ƙirƙiri buƙata
POST /api/merchant/payment-requests
Matsayin ɗan kasuwa
GET /api/merchant/payment-requests/{reference}/status
Matsayin jama’a
GET /api/payments/{reference}/status
Aika tx hash
POST /api/merchant/payment-requests/{reference}/confirmations
Endpoint na webhook
POST /api/merchant/webhook-endpoints
Abin da ya faru na webhook
POST /api/merchant/webhook-events

Metadata na biyan kuɗi

Cibiyar sadarwa
FTY on Ethereum mainnet
Chain ID
137
Settlement currency
FTY
Customer preferences
FTY, ETH, BTC, USDC, USDT
Sasantawa
Furety Treasury Safe ko walat da ɗan kasuwa ya saita kuma aka amince da shi
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',
]);

Ka’idojin tsaro

Wannan API never asks don private keys, seed phrases, card details, bank credentials, ko raw webhook signing secrets. Raw API keys are shown only once at creation da stored as hashes.

preferred_customer_currency accepts FTY, ETH, BTC, USDC, da USDT. FTY remains the settlement and sabis amfani currency unless a supported biyan kuɗi processor flow is explicitly enabled.

Maɓallan API suna shirye don iyakance yawan amfani kuma an takaita su ga yan kasuwa da aka amince da su. Dole ne ƙimar sa hannun webhook su kasance a Google Secret Manager ta hanyar tunani kawai.

FTY is a amfani biyan kuɗi currency. Furety does not offer staking, lending, yield, guaranteed returns, ko exchange-price promises.