Credits और टॉपअप

टॉपअप ड्राफ्ट का अनुरोध करने के लिए write टोकन का उपयोग करें। भुगतान से पहले pricing से वर्तमान न्यूनतम राशि, प्रति-एसेट दरें, उपलब्धता, बोनस और सीमाएँ (caps) पढ़ें। उदाहरण राशि कम से कम 10,000 क्रेडिट है और इस इंस्टेंस की कॉन्फ़िगर की गई न्यूनतम राशि से कभी कम नहीं होती। क्रेडिट USD-आधारित हैं; एसेट राशियाँ उद्धृत (quoted) होती हैं, निश्चित नहीं। ड्राफ्ट एक निर्देश है, क्रेडिट बुकिंग नहीं।

curl -X POST 'https://ftso.app/api/x402/topup' \
  -H 'authorization: Bearer fbx_WRITE_TOKEN' \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: topup_20260930_001' \
  -d '{"credits":10000,"asset":"FBEST"}'
# asset: FBEST | WFLR | FXRP | FLR | XRP

ड्राफ्ट PaymentRouter पता, asset, amountRaw, deadline, signedBy, typedData और signature लौटाता है। FXRP छह दशमलव स्थान उपयोग करता है; इसे 18-दशमलव टोकन न समझें। अपेक्षित router और treasury को सार्वजनिक कॉन्फ़िगरेशन से मिलाएँ, settlementSigner() पढ़ें और EIP-712 सिग्नेचर को क्रिप्टोग्राफ़िक रूप से सत्यापित करें। केवल signedBy की तुलना करना सिग्नेचर का सत्यापन नहीं है। approve करने और pay() कॉल करने से पहले buyer, asset, amount, chain, deadline, feeBps=0 और mode=0 की पुष्टि करें।

// draft is response.topup; router and token are viem contract instances.
// Verify the complete authorization before approval or payment.
const m = draft.typedData.message;
await token.write.approve([draft.routerAddress, BigInt(draft.amountRaw)]);
const txHash = await router.write.pay([
  { ...m, amount: BigInt(m.amount), deadline: BigInt(m.deadline), nonce: m.nonce },
  draft.signature,
]);

curl -X POST 'https://ftso.app/api/x402/topup/HANDLE/confirm' \
  -H 'authorization: Bearer fbx_WRITE_TOKEN' \
  -H 'content-type: application/json' \
  -d '{"txHash":"0xPAY_TRANSACTION_HASH"}'

पुष्टि क्रेडिट देने से पहले भुगतान सत्यापित करती है। केवल ट्रांज़ैक्शन हैश भुगतान किए गए टॉपअप का प्रमाण नहीं है। Router अधिकृत राशि स्थानांतरित करता है; दोहरी पुष्टि से क्रेडिट दो बार नहीं मिल सकते।

ड्राफ्ट का amountWei chain 14 पर payTo को भेजें, साथ में उसका सटीक 32-बाइट dataHex हैंडल रखें। किसी टोकन approval की आवश्यकता नहीं है। फिर ट्रांज़ैक्शन हैश की पुष्टि करें। क्रेडिट वितरित मूल्य पर निर्भर करते हैं, नीचे की ओर पूर्णांकित और कॉन्फ़िगर की गई सीमाओं (caps) द्वारा सीमित।

await wallet.sendTransaction({
  to: draft.payTo,
  value: BigInt(draft.amountWei),
  data: draft.dataHex,
  chainId: 14,
});

लौटाए गए XRPL पते और destinationTag का amountDrops के साथ उपयोग करें। Destination tag भुगतान को सही टॉपअप से जोड़ता है। read टोकन से स्टेटस एंडपॉइंट को पोल करें; Worker सत्यापित वितरित भुगतान को असिंक्रोनस रूप से क्रेडिट करता है। पूर्ण होने का कोई गारंटीशुदा समय नहीं है। वैकल्पिक FDC attestation क्रेडिट के बाद होता है और उसकी शर्त नहीं है। verifiedByFdc false रह सकता है।

curl 'https://ftso.app/api/x402/topup/HANDLE' \
  -H 'authorization: Bearer fbx_READ_TOKEN'

ड्राफ्ट की deadline का पालन करें। देर से किए गए आनुपातिक FLR/XRP भुगतान फ़्रीज़ की गई और वर्तमान दर में से कम वाली दर का उपयोग करते हैं; वर्तमान कीमत के बिना Worker प्रतीक्षा करता है। प्रति-टॉपअप सीमाएँ क्रेडिट किए गए अधिक भुगतान को सीमित करती हैं; एसेट होल्डिंग्स सीमा पार होने पर नए ड्राफ्ट रुक जाते हैं। कभी भी Router ऑर्डर, dataHex या destinationTag के बिना न भेजें: एप्लिकेशन ऐसे भुगतान को विश्वसनीय रूप से नहीं जोड़ सकता।

Bearer सब्सक्रिप्शन खरीद के लिए 8–128 अक्षरों, अंकों, अंडरस्कोर या हाइफ़न का Idempotency-Key आवश्यक है। यह हेडर Watch बनाने, टॉपअप ड्राफ्ट, प्राप्तकर्ता बनाने और चैनल PUT के लिए भी समर्थित है। टाइमआउट के बाद वही key और body दोबारा उपयोग करें। अंतिम प्रतिक्रियाएँ 24 घंटे तक रखी जाती हैं; बदले हुए body पर 409 idempotency_key_reused मिलता है। सक्रिय lease पर Retry-After के साथ 409 idempotency_in_progress मिलता है। पुनः प्रयास योग्य विफलताएँ key को मुक्त करती हैं; समाप्त ड्राफ्ट पर 410 draft_expired मिलता है। Replays रेट लिमिट में गिने जाते हैं। लौटाए गए secrets उसी वॉलेट के replay से 24 घंटे तक पुनः प्राप्त किए जा सकते हैं।

अर्जित क्रेडिट खरीदे गए क्रेडिट से अलग गिने जाते हैं। मौजूदा FBEST रूपांतरण एक अनुरोध, admin स्वीकृति और ConversionVault पर वॉलेट claim का उपयोग करता है; स्वचालित भुगतान लागू नहीं है। उपयोगकर्ता वर्कफ़्लो के लिए Credits देखें।

वर्तमान में सक्रिय दरों, उपलब्धता और कॉन्फ़िगरेशन के लिए /api/x402/pricing का उपयोग करें। यह अनुभाग इस एप्लिकेशन इंस्टेंस की कॉन्फ़िगरेशन पढ़ता है; यह Treasury या किसी दूरस्थ सर्वर से पूछताछ नहीं करता।

• न्यूनतम टॉपअप क्रेडिट: 10000
• USD प्रति 1,000 क्रेडिट: 1

• FBEST: प्रति-टॉपअप अधिकतम: कोई कॉन्फ़िगर की गई सीमा नहीं; Treasury होल्डिंग्स सीमा: कोई कॉन्फ़िगर की गई सीमा नहीं.
• WFLR: प्रति-टॉपअप अधिकतम: कोई कॉन्फ़िगर की गई सीमा नहीं; Treasury होल्डिंग्स सीमा: कोई कॉन्फ़िगर की गई सीमा नहीं.
• FXRP: प्रति-टॉपअप अधिकतम: 1000; Treasury होल्डिंग्स सीमा: 5000.
• FLR: प्रति-टॉपअप अधिकतम: कोई कॉन्फ़िगर की गई सीमा नहीं; Treasury होल्डिंग्स सीमा: कोई कॉन्फ़िगर की गई सीमा नहीं.
• XRP: प्रति-टॉपअप अधिकतम: 1000; Treasury होल्डिंग्स सीमा: 5000.