FaucetPay API संदर्भ।
एक ही REST एंडपॉइंट से माइक्रो-भुगतान भेजें, उपयोगकर्ताओं को सत्यापित करें और बैलेंस देखें। फ़ॉर्म-एन्कोडेड अनुरोध, JSON प्रतिक्रियाएं, हर फॉसेट के लिए एक api_key।
FaucetPay पर फ़ॉसेट, भुगतान और स्वचालन बनाएँ।
HTTPS पर एक छोटा, अनुमानित REST API। प्रत्येक एंडपॉइंट form-encoded POST बॉडी स्वीकार करता है, शीर्ष-स्तरीय स्थिति पूर्णांक के साथ JSON लौटाता है और आपके फ़ॉसेट की api_key से प्रमाणित होता है। कोई OAuth नहीं, कोई SDK नहीं।
HTTPS पर REST
प्रत्येक एंडपॉइंट form-encoded POST बॉडी स्वीकार करता है और JSON लौटाता है।
प्रति फ़ॉसेट एक कुंजी
आपका फ़ॉसेट api_key हर अनुरोध को प्रमाणित करता है। इसे सर्वर पर रखें।
IP-जागरूक
/send के साथ ip_address भेजें ताकि क्रॉस-फ़ॉसेट अब्यूज़ डिटेक्शन सक्रिय हो।
https://faucetpay.io/api/v1प्रत्येक अनुरोध के साथ अपनी api_key भेजें।
प्रत्येक POST बॉडी के api_key फ़ील्ड में अपने फ़ॉसेट की api_key पास करें।
एक मिनट से कम में अपना पहला भुगतान भेजें।
YOUR_API_KEY को वास्तविक फ़ॉसेट कुंजी से बदलें, टेस्ट उपयोगकर्ता पर निर्देशित करें (अपना ईमेल काम करता है) और चलाएँ।
curl -X POST https://faucetpay.io/api/v1/send \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "api_key=YOUR_API_KEY&amount=100&[email protected]¤cy=BTC"
अनुरोध और प्रतिक्रिया प्रारूप।
सभी एंडपॉइंट POST, form-encoded हैं और JSON लौटाते हैं। लिफ़ाफ़ा सभी एंडपॉइंट पर समान है ताकि आपका क्लाइंट कोड पार्सिंग लॉजिक साझा कर सके।
Content-Type: application/x-www-form-urlencoded api_key=YOUR_API_KEY amount=100 [email protected] currency=BTC ip_address=203.0.113.4
{
"status": 200,
"message": "Payout completed successfully!",
// …endpoint-specific fields
}प्रतिक्रिया लिफ़ाफ़ा
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| statusआवश्यक | integer | स्थिति |
| messageआवश्यक | string | संदेश |
| …वैकल्पिक | varies | डेटा |
API सतह
पाँच एंडपॉइंट हर फ़ॉसेट-स्वामी परिदृश्य को कवर करते हैं: भुगतान भेजना, उपयोगकर्ता सत्यापित करना, बैलेंस जाँचना, इतिहास सूचीबद्ध करना और सिक्का सूची निरीक्षण करना।
/sendSend
अपने खाता बैलेंस से FaucetPay उपयोगकर्ता को क्रिप्टो भुगतान करें।
बॉडी पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| api_keyआवश्यक | string | आपके फ़ॉसेट की API कुंजी। |
| amountआवश्यक | integer | सिक्के की सबसे छोटी इकाई में राशि (BTC के लिए सातोशी)। |
| toआवश्यक | string | गंतव्य: ईमेल, उपयोगकर्ता नाम, वॉलेट पता, या payout_user_hash। |
| currencyआवश्यक | string | बड़े अक्षरों में सिक्का प्रतीक, जैसे BTC, DOGE, USDT। |
| ip_addressवैकल्पिक | string | क्लेमर IP — दृढ़ता से अनुशंसित; एंटी-अब्यूज़ रेट-लिमिटिंग सक्षम करता है। |
| referralवैकल्पिक | string | इस भुगतान के लिए रेफरल टैग, अपनी रिपोर्टिंग के लिए। |
अनुरोध उदाहरण
curl -X POST https://faucetpay.io/api/v1/send \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "api_key=YOUR_API_KEY&amount=100&[email protected]¤cy=BTC&ip_address=203.0.113.4"
प्रतिक्रिया उदाहरण
{
"status": 200,
"message": "OK",
"rate_limit_remaining": 0.00049900,
"currency": "BTC",
"balance": 49900,
"balance_bitcoin": 0.00049900,
"payout_id": 12834721,
"payout_user_hash": "3f9c1a2e6b7d0f5e8c4a9b2d1f6e0c8a7b5d2e91"
}/checkaddressCheck address
जाँचें कि गंतव्य चयनित मुद्रा के लिए पंजीकृत FaucetPay उपयोगकर्ता है।
बॉडी पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| api_keyआवश्यक | string | आपके फ़ॉसेट की API कुंजी। |
| addressआवश्यक | string | सत्यापित करने के लिए ईमेल, उपयोगकर्ता नाम, वॉलेट पता, या payout_user_hash। |
| currencyआवश्यक | string | सदस्यता जाँचने के लिए बड़े अक्षरों में सिक्का प्रतीक। |
अनुरोध उदाहरण
curl -X POST https://faucetpay.io/api/v1/checkaddress \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "api_key=YOUR_API_KEY&[email protected]¤cy=BTC"
प्रतिक्रिया उदाहरण
{
"status": 200,
"message": "This address belongs to a FaucetPay user.",
"payout_user_hash": "3f9c1a2e6b7d0f5e8c4a9b2d1f6e0c8a7b5d2e91"
}/getbalanceCheck balance
किसी दिए गए सिक्के के लिए वर्तमान फ़ॉसेट बैलेंस प्राप्त करें।
बॉडी पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| api_keyआवश्यक | string | आपके फ़ॉसेट की API कुंजी। |
| currencyआवश्यक | string | बड़े अक्षरों में सिक्का प्रतीक। |
अनुरोध उदाहरण
curl -X POST https://faucetpay.io/api/v1/getbalance \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "api_key=YOUR_API_KEY¤cy=BTC"
प्रतिक्रिया उदाहरण
{
"status": 200,
"message": "OK",
"currency": "BTC",
"balance": 49900,
"balance_bitcoin": 0.00049900
}/payoutsList payouts
अपने सबसे हाल के भुगतान लौटाएँ, नवीनतम पहले।
बॉडी पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| api_keyआवश्यक | string | आपके फ़ॉसेट की API कुंजी। |
| countवैकल्पिक | integer | कितने भुगतान लौटाए जाएँ (1–100, डिफ़ॉल्ट 10)। |
| currencyवैकल्पिक | string | एकल सिक्के पर फ़िल्टर करें। सभी के लिए छोड़ दें। |
अनुरोध उदाहरण
curl -X POST https://faucetpay.io/api/v1/payouts \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "api_key=YOUR_API_KEY&count=5¤cy=BTC"
प्रतिक्रिया उदाहरण
{
"status": 200,
"message": "OK",
"rewards": [
{
"to": "[email protected]",
"amount": 100,
"date": "02-05-26 21:12:00 GMT"
}
]
}/currenciesSupported currencies
FaucetPay पर वर्तमान में सक्रिय प्रत्येक मुद्रा लौटाएँ।
बॉडी पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| api_keyआवश्यक | string | आपके फ़ॉसेट की API कुंजी। |
अनुरोध उदाहरण
curl -X POST https://faucetpay.io/api/v1/currencies \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "api_key=YOUR_API_KEY"
प्रतिक्रिया उदाहरण
{
"status": 200,
"message": "OK",
"currencies": ["BTC", "ETH", "USDT", "LTC", "DOGE"],
"currencies_names": [
{ "name": "Bitcoin", "acronym": "BTC" },
{ "name": "Ethereum", "acronym": "ETH" },
{ "name": "Tether", "acronym": "USDT" },
{ "name": "Litecoin", "acronym": "LTC" },
{ "name": "Dogecoin", "acronym": "DOGE" }
]
}स्थिति कोड।
प्रत्येक एंडपॉइंट इनमें से एक स्थिति कोड लौटाता है।
| कोड | स्वर | अर्थ |
|---|---|---|
| 200 | सफल | OK — अनुरोध सफल |
| 403 | त्रुटि | निषिद्ध — अमान्य या अनुपस्थित api_key |
| 405 | त्रुटि | विधि अनुमत नहीं — POST का उपयोग करें |
| 413 | चेतावनी | पेलोड बहुत बड़ा |
| 414 | चेतावनी | URI बहुत लंबा |
| 415 | चेतावनी | असमर्थित मीडिया प्रकार — application/x-www-form-urlencoded का उपयोग करें |
| 416 | त्रुटि | अनुरोधित सीमा संतुष्ट नहीं |
| 417 | त्रुटि | प्रत्याशा विफल |
| 418 | चेतावनी | मैं एक चायदानी हूँ |
| 419 | त्रुटि | प्रमाणीकरण समय समाप्त |
| 420 | चेतावनी | रेट सीमित — बहुत अधिक अनुरोध |
| 421 | त्रुटि | ग़लत दिशा अनुरोध |
| 422 | चेतावनी | प्रोसेस न की जा सकने वाली इकाई — सत्यापन त्रुटि |
| 456 | त्रुटि | अनुत्थापनीय त्रुटि |
समर्थित सिक्के।
FaucetPay पर सक्रिय प्रत्येक सिक्का भुगतान के लिए उपलब्ध है।
रेट लिमिट।
सीमाएँ प्रति फ़ॉसेट api_key लागू होती हैं और आपके एकीकरण और हमारे नेटवर्क को स्वस्थ रखती हैं।
60 / मिनट
प्रति फ़ॉसेट api_key। 120 तक बर्स्ट स्वीकार्य।
बर्स्ट विंडो
सीमा से ऊपर छोटे बर्स्ट 2 सेकंड तक स्वीकार्य हैं।
सुरक्षा सर्वोत्तम अभ्यास।
एक छोटी, राय वाली चेकलिस्ट। प्रत्येक आइटम एक घटना वर्ग से मेल खाता है जो हमने व्यवहार में देखा है।
- अपनी api_key कभी ब्राउज़र पर न भेजें। इसे पासवर्ड की तरह रखें: केवल बैकएंड, सीक्रेट्स मैनेजर, git में कभी नहीं।
- हमेशा /send के साथ ip_address भेजें। यह क्रॉस-फ़ॉसेट अब्यूज़ डिटेक्शन सक्रिय करता है।
- सातोशी में राशि इकाइयाँ सत्यापित करें। एक सामान्य बग भिन्नात्मक मान भेजना है बजाय न्यूनतम-इकाई पूर्णांक के।
- सर्वर-साइड पर क्लेम डीडुप करें। डबल-सबमिट रोकने के लिए क्लाइंट पर निर्भर न रहें।
- नियमित रूप से कुंजी रोटेट करें। हम हॉट रोटेशन समर्थन करते हैं: पुरानी कुंजी पुष्टि पर बंद हो जाती हैं।
कुछ अस्पष्ट है?
हेल्प डेस्क पर टिकट खोलें और हम दस्तावेज़ अपडेट करेंगे।
स्कोप्ड, रिवोकेबल कुंजी बियरर टोकन के साथ।
v2 API आधुनिक स्वचालन सतह है। एक सर्व-शक्तिशाली कुंजी के बजाय, आप संकरी कुंजी (read / send / manage / admin) बनाते हैं, उन्हें बियरर टोकन के रूप में भेजते हैं और सुसंगत JSON लिफ़ाफ़ा पाते हैं। ऊपर legacy /api/v1 अपरिवर्तित रहता है।
बियरर टोकन प्रमाणीकरण
कुंजी को Authorization: Bearer '<key>' के रूप में भेजें।
न्यूनतम-विशेषाधिकार स्कोप
केवल उस स्कोप के साथ कुंजी बनाएँ जो टूल को चाहिए।
सुसंगत JSON लिफ़ाफ़ा
प्रत्येक v2 प्रतिक्रिया समान {status, message, data} आकार का उपयोग करती है।
https://faucetpay.io/api/v2उदाहरण — प्रमाणित अनुरोध
curl -X POST https://faucetpay.io/api/v2/balances \
-H "Authorization: Bearer YOUR_SCOPED_KEY" \
-H "Content-Type: application/json" \
-d '{}'प्रमाणीकरण और स्कोप।
अपने फ़ॉसेट के Manage पेज से स्कोप्ड कुंजी बनाएँ। प्रत्येक कुंजी एक बार दिखाई जाती है, हैश के रूप में संग्रहीत होती है, और प्रति-कुंजी IP व्हाइटलिस्ट और (send के लिए) दैनिक USD सीमा ले सकती है।
बैलेंस, भुगतान, आँकड़े, मुद्राएँ, सेटिंग्स और एंटी-फ्रॉड स्थिति पढ़ें।
भुगतान करें — वास्तविक धन ले जाता है। केवल सर्वर-साइड रखें।
फ़ॉसेट सेटिंग्स, रेट लिमिट, IP व्हाइटलिस्ट और एंटी-फ्रॉड नियम बदलें।
फ़ॉसेट बनाएँ और लिस्टिंग अनुमोदन का अनुरोध करें। फ़ॉसेट नहीं हटा सकते।
एंडपॉइंट।
प्रत्येक v2 एंडपॉइंट Bearer प्रमाणीकरण और मानक लिफ़ाफ़ा लौटाता है।
| एंडपॉइंट | स्कोप | बॉडी | विवरण |
|---|---|---|---|
/balance | read | currency? | किसी सिक्के के लिए फ़ॉसेट बैलेंस जाँचें। |
/balances | read | — | सभी सिक्कों के बैलेंस सूचीबद्ध करें। |
/currencies | read | — | समर्थित मुद्राएँ सूचीबद्ध करें। |
/check-address | read | address | गंतव्य पता सत्यापित करें। |
/payouts | read | currency?, count? | हाल के भुगतान सूचीबद्ध करें। |
/faucet | read | — | फ़ॉसेट विवरण प्राप्त करें |
/stats/daily | read | — | दैनिक आँकड़े |
/stats/users | read | coin, page | उपयोगकर्ता आँकड़े |
/transactions | read | coin, page | लेन-देन |
/ratelimits | read | — | रेट लिमिट |
/low-balance-notification | read | — | कम बैलेंस अलर्ट |
| एंडपॉइंट | स्कोप | बॉडी | विवरण |
|---|---|---|---|
/faucet/update | manage | faucet_name, faucet_domain, faucet_url, faucet_description, timer_minutes, currencies_selected?, categories_selected? | फ़ॉसेट सेटिंग्स अपडेट करें |
/ratelimits/set | manage | ratelimits[] | रेट लिमिट सेट करें |
/ip-whitelist | manage | — | IP व्हाइटलिस्ट |
/ip-whitelist/set | manage | ip_whitelist | IP व्हाइटलिस्ट अपडेट करें |
/low-balance-notification/toggle | manage | — | कम बैलेंस अलर्ट टॉगल करें |
| एंडपॉइंट | स्कोप | बॉडी | विवरण |
|---|---|---|---|
/anti-fraud/rules | manage | — | एंटी-फ्रॉड नियम |
/anti-fraud/toggle | manage | — | एंटी-फ्रॉड टॉगल करें |
/anti-fraud/rules/update | manage | trust_rank, negative_rank?, whitelist?, blacklist? | एंटी-फ्रॉड नियम अपडेट करें |
| एंडपॉइंट | स्कोप | बॉडी | विवरण |
|---|---|---|---|
/send | send | idempotency_key, currency, amount, to, ip_address?, referral? | भुगतान भेजें |
| एंडपॉइंट | स्कोप | बॉडी | विवरण |
|---|---|---|---|
/faucet/create | admin | faucet_name, faucet_domain, faucet_url | फ़ॉसेट बनाएँ |
/approval-cost | admin | coin | लिस्टिंग अनुमोदन लागत |
/faucet/request-approval | admin | coin | लिस्टिंग अनुमोदन का अनुरोध करें |
भुगतान भेजना।
v2 send भुगतान का सुरक्षित तरीका है: इसे idempotency कुंजी चाहिए और यह प्रति-कुंजी वैकल्पिक दैनिक USD सीमा का पालन करता है। यह legacy send के समान एंटी-फ्रॉड / बैलेंस / रेट-लिमिट पथ का उपयोग करता है।
/sendsendआइडेम्पोटेंसी और वैकल्पिक दैनिक सीमा के साथ भुगतान भेजें।
बॉडी पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| idempotency_keyआवश्यक | string | प्रत्येक लॉजिकल भुगतान के लिए अद्वितीय। उसी कुंजी के साथ रीट्राय कभी दोहरा भुगतान नहीं करता। |
| toआवश्यक | string | प्राप्तकर्ता: ईमेल, उपयोगकर्ता नाम, वॉलेट पता, या payout_user_hash। |
| amountआवश्यक | integer | सिक्के की सबसे छोटी इकाई में राशि (जैसे BTC के लिए सातोशी)। |
| currencyआवश्यक | string | बड़े अक्षरों में सिक्का प्रतीक, जैसे BTC, DOGE। |
| ip_addressवैकल्पिक | string | प्राप्तकर्ता IP — एंटी-फ्रॉड के लिए अनुशंसित। |
| referralवैकल्पिक | string | अपनी रिपोर्टिंग के लिए रेफरल टैग। |
अनुरोध उदाहरण
curl -X POST https://faucetpay.io/api/v2/send \
-H "Authorization: Bearer YOUR_SCOPED_KEY" \
-H "Content-Type: application/json" \
-d '{"idempotency_key":"claim-8f3a1c2e","to":"[email protected]","amount":100,"currency":"BTC","ip_address":"203.0.113.4"}'प्रतिक्रिया उदाहरण
{
"success": true,
"message": "OK",
"data": {
"rate_limit_remaining": 0.00049900,
"currency": "BTC",
"balance": 49900,
"balance_bitcoin": 0.00049900,
"payout_id": 12834721,
"payout_user_hash": "3f9c1a2e6b7d0f5e8c4a9b2d1f6e0c8a7b5d2e91"
}
}Webhooks.
भुगतान घटनाओं की सदस्यता लें और HMAC-हस्ताक्षरित POST प्राप्त करें। अपने फ़ॉसेट के Manage पेज से कॉन्फ़िगर करें — वेबहुक प्रबंधन केवल सत्र + 2FA है, इसलिए स्कोप्ड कुंजी कभी डिलीवरी एंडपॉइंट रजिस्टर नहीं कर सकती।
घटना-संचालित
payout.sent और payout.failed घटनाओं की सदस्यता लें।
HMAC-हस्ताक्षरित
प्रत्येक डिलीवरी में X-FaucetPay-Signature हेडर होता है जिसमें body का HMAC-SHA256 होता है।
SSRF सुरक्षा
वेबहुक URL सार्वजनिक HTTPS एंडपॉइंट होने चाहिए। आंतरिक IP अस्वीकृत हैं।
डिलीवरी उदाहरण
POST https://your-site.example/webhooks/faucetpay
X-FaucetPay-Signature: sha256=4b0c…e91
{
"id": "9f2c1a…",
"event": "payout.sent",
"faucet_id": 1234,
"created_at": 1717365120,
"data": {
"to": "[email protected]",
"amount": 100,
"currency": "BTC",
"payout_id": "payout_9nq0xk2l",
"payout_user_hash": "3f9c…",
"message": "Payout completed successfully!"
}
}हस्ताक्षर सत्यापित करें
import crypto from 'node:crypto';
// rawBody = the exact bytes you received (verify BEFORE JSON.parse)
const signature = req.headers['x-faucetpay-signature']; // 'sha256=<hex>'
const expected =
'sha256=' + crypto.createHmac('sha256', WEBHOOK_SECRET).update(rawBody).digest('hex');
const ok =
signature &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
if (!ok) return res.status(401).end();त्रुटियाँ।
v2 मानक HTTP स्थिति कोड और लिफ़ाफ़े में विवरणात्मक संदेश का उपयोग करता है।
| कोड | स्वर | अर्थ |
|---|---|---|
| 200 | सफल | 200 OK |
| 400 | चेतावनी | 400 ग़लत अनुरोध |
| 401 | त्रुटि | 401 अनधिकृत |
| 403 | त्रुटि | 403 निषिद्ध |
| 409 | चेतावनी | 409 विरोध |
| 429 | चेतावनी | 429 बहुत अधिक अनुरोध |
किसी भी AI एजेंट से अपने फ़ॉसेट को प्रबंधित करें।
FaucetPay MCP सर्वर AI सहायक (Cursor, Claude Code, Windsurf, …) को मॉडल कॉन्टेक्स्ट प्रोटोकॉल के माध्यम से फ़ॉसेट पढ़ने और सेटिंग्स समायोजित करने की अनुमति देता है। यह v2 API पर एक पतला क्लाइंट है — केवल read + manage।
पतली परत
MCP सर्वर v2 API पर एक पतला रैपर है — कोई अतिरिक्त स्थिति नहीं।
कोई धन उपकरण नहीं
सर्वर कोई भुगतान उपकरण नहीं देता। यह पढ़ और प्रबंधित कर सकता है, लेकिन धन नहीं भेज सकता।
कुछ भी स्थापित नहीं
सर्वर दूरस्थ रूप से चलता है। बस अपने AI सहायक को URL पर निर्देशित करें।
कनेक्ट और कॉन्फ़िगर करें।
FaucetPay MCP सर्वर को अपने AI सहायक कॉन्फ़िग में जोड़ें। अपने फ़ॉसेट को स्कोप्ड read या manage कुंजी के साथ निर्देशित करें।
// ~/.cursor/mcp.json
{
"mcpServers": {
"faucetpay": {
"url": "https://mcp.faucetpay.io/mcp",
"headers": { "Authorization": "Bearer fpk_your_read_or_manage_key" }
}
}
}कॉन्फ़िगरेशन
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| urlआवश्यक | string | MCP सर्वर URL |
| Authorizationआवश्यक | header | स्कोप्ड API कुंजी (read या manage स्कोप) |
उपकरण।
MCP सर्वर द्वारा प्रदानित केवल-पढ़ने और प्रबंधन उपकरण।
पढ़ने के उपकरण
get_faucetफ़ॉसेट विवरण प्राप्त करेंget_balancesफ़ॉसेट बैलेंस प्राप्त करेंget_balanceकिसी सिक्के के लिए वर्तमान फ़ॉसेट बैलेंस प्राप्त करें।get_payoutsहाल के भुगतान सूचीबद्ध करेंget_currenciesसमर्थित मुद्राएँ और सीमाएँ सूचीबद्ध करें।check_addressजाँचें कि पता एक पंजीकृत FaucetPay उपयोगकर्ता है या नहीं।get_daily_statsदैनिक आँकड़े प्राप्त करेंget_user_statsउपयोगकर्ता आँकड़े प्राप्त करेंget_transactionsलेन-देन सूचीबद्ध करेंget_ratelimitsरेट लिमिट प्राप्त करेंget_low_balance_notificationकम बैलेंस सेटिंग्स प्राप्त करें
प्रबंधन उपकरण
get_ip_whitelistIP व्हाइटलिस्ट प्राप्त करेंset_ip_whitelistIP व्हाइटलिस्ट अपडेट करेंget_anti_fraudएंटी-फ्रॉड सेटिंग्स प्राप्त करेंtoggle_anti_fraudएंटी-फ्रॉड टॉगल करेंupdate_anti_fraud_rulesएंटी-फ्रॉड नियम अपडेट करेंupdate_faucet_settingsफ़ॉसेट सेटिंग्स अपडेट करेंset_ratelimitsरेट लिमिट सेट करेंtoggle_low_balance_notificationकम बैलेंस अलर्ट टॉगल करें
सुरक्षा और सर्वोत्तम अभ्यास।
MCP सर्वर का सुरक्षित उपयोग करने के सर्वोत्तम अभ्यास।
- read या manage कुंजी का उपयोग करें — कभी send कुंजी नहीं। इस सर्वर में कोई भुगतान उपकरण नहीं है।
- छोटी समाप्ति सेट करें। कुंजी को जीवनकाल दें ताकि पुरानी कॉन्फ़िग हमेशा दुरुपयोग न हो।
- उजाग होने पर तुरंत रद्द करें। Manage पेज पर एक क्लिक से कुंजी बंद हो जाती है।
- एंटी-फ्रॉड सलाह पर ध्यान दें। एंटी-फ्रॉड को बंद या कमज़ोर करने पर चेतावनी मिलती है।
अधिक कमाएँ
FaucetPay विज्ञापन नेटवर्क के साथ अपने फ़ॉसेट को मुद्रीकृत करें।
Accept crypto payments in your store.
The Merchant API lets any website accept payments from FaucetPay users through a hosted checkout page. The buyer pays from their FaucetPay balance and the funds settle to your account instantly — no keys or server-side SDK required to get started.
Hosted checkout
You submit a plain HTML form; FaucetPay hosts the whole payment page. Nothing sensitive ever touches your server.
Any supported coin
Price in one currency and let the buyer pay with any coin FaucetPay supports — or pin the payment coin yourself.
Instant settlement
Payments move between FaucetPay balances, so they confirm instantly with no on-chain fees or waiting.
The payment form.
Checkout starts with a simple HTML form POSTed to the FaucetPay checkout endpoint. The buyer is taken to a FaucetPay-hosted page to review and confirm the payment.
Submit the form with a standard browser POST (not XHR) — the buyer must land on the hosted checkout page to confirm the payment.
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
| merchant_usernameआवश्यक | string | Your FaucetPay username — the account that receives the payment. |
| item_descriptionआवश्यक | string | Description of the item or service the buyer is paying for. |
| amount1आवश्यक | string | Amount you want to receive, denominated in currency1. |
| currency1आवश्यक | string | The pricing currency of your store (e.g. USDT, BTC, …). |
| currency2वैकल्पिक | string | The coin the buyer must pay with. Leave blank to let the buyer choose any supported coin. |
| customवैकल्पिक | string | An identifier passed back on the callback — use it for your order ID or user ID. |
| callback_urlवैकल्पिक | string | URL that receives the server-to-server POST callback once the payment completes. |
| success_urlवैकल्पिक | string | URL the buyer is redirected to after a successful payment. |
| cancel_urlवैकल्पिक | string | URL the buyer is redirected to if they cancel. |
Example HTML form
<form action="https://faucetpay.io/merchant/webscr" method="post"> <input type="hidden" name="merchant_username" value="YOUR_USERNAME"> <input type="hidden" name="item_description" value="PlayStation 5"> <input type="hidden" name="amount1" value="100"> <input type="hidden" name="currency1" value="USDT"> <input type="hidden" name="currency2" value=""> <input type="hidden" name="custom" value="order-4564211"> <input type="hidden" name="callback_url" value="https://your-site.com/ipn"> <input type="hidden" name="success_url" value="https://your-site.com/success"> <input type="hidden" name="cancel_url" value="https://your-site.com/cancel"> <input type="submit" name="submit" value="Pay with FaucetPay"> </form>
Callback & verification.
After a completed payment, FaucetPay POSTs a form-encoded callback to your callback_url with the payment details and a single-use verification token. Verify the token server-side before delivering the goods.
Example callback (IPN)
POST https://your-site.com/ipn Content-Type: application/x-www-form-urlencoded token=1a2b3c4d5e6f7a8b9c0d &transaction_id=87654321 &merchant_username=your_username &payer_username=buyer_username &amount1=100 ¤cy1=USDT &amount2=0.00105 ¤cy2=BTC &custom=order-4564211 &exchange_rate=95238.09
Verify the token
GET https://faucetpay.io/merchant/get-payment/{token}
{
"valid": true,
"transaction_id": "87654321",
"merchant_username": "your_username",
"payer_username": "buyer_username",
"amount1": "100",
"currency1": "USDT",
"amount2": "0.00105",
"currency2": "BTC",
"custom": "order-4564211"
}Retry schedule
We expect that you respond to the callback request with an HTTP 200 OK response. If we don't receive a 200 response, our system will assume that the request has failed and will reattempt the callback based on the following schedule.
- 1st Callback:Immediately (After Payment)
- 2nd Callback:5 Minutes Delay
- 3rd Callback:15 Minutes Delay
- 4th Callback:30 Minutes Delay
- 5th Callback:60 Minutes Delay
- 6th Callback:120 Minutes Delay
- 7th Callback:240 Minutes Delay