भुगतान बनाना
post
https://api.cryptomus.com/v1/payout
एपीआई के माध्यम से भुगतान केवल आपके बिजनेस वॉलेट बैलेंस से किया जाता है।
भुगतान विभिन्न तरीकों से किया जा सकता है:
- आप किसी विशिष्ट क्रिप्टोकरेंसी में भुगतान प्राप्त करना चुन सकते हैं और भुगतान स्वचालित रूप से उसी विशिष्ट क्रिप्टोकरेंसी में संसाधित हो जाएगा। ऐसा करने के लिए, सुनिश्चित करें कि आपके पास उस विशिष्ट मुद्रा में सभी संबंधित शुल्कों को कवर करने के लिए पर्याप्त शेष राशि हो।
- वैकल्पिक रूप से, आपके पास भुगतान राशि को किसी फ़िएट मुद्रा में निर्दिष्ट करने का विकल्प भी है। इस स्थिति में, राशि आपके उपलब्ध शेष से स्वचालित रूप से एक विशिष्ट क्रिप्टोकरेंसी में परिवर्तित हो जाएगी। उदाहरण के लिए, यदि आप LTC में 20 USD का भुगतान चाहते हैं, तो समतुल्य राशि आपके LTC शेष से काट ली जाएगी। सभी लागू शुल्कों को कवर करने के लिए संबंधित क्रिप्टोकरेंसी में पर्याप्त धनराशि होना महत्वपूर्ण है।
- एक और विकल्प यह है कि भुगतान राशि को किसी फ़िएट मुद्रा में निर्दिष्ट किया जाए, जो आपके USDT बैलेंस का उपयोग करके स्वचालित रूप से एक विशिष्ट क्रिप्टोकरेंसी में परिवर्तित हो जाएगी। यह विकल्प विशेष रूप से तब उपयोगी होता है जब आपने ऑटोकन्वर्ट सक्षम किया हो, क्योंकि आपके इनवॉइस की धनराशि स्वचालित रूप से USDT में परिवर्तित हो जाती है। उदाहरण के लिए, यदि आप LTC में 20 USD का भुगतान करना चाहते हैं, लेकिन आपके पास केवल USDT बैलेंस है, तो सुनिश्चित करें कि आपके पास सभी शुल्कों को पूरा करने के लिए पर्याप्त USDT धनराशि हो।
- इसके अलावा, आप अपनी पसंद की किसी भी क्रिप्टोकरेंसी में भुगतान राशि निर्दिष्ट कर सकते हैं। फिर भुगतान स्वचालित रूप से उस विशिष्ट क्रिप्टोकरेंसी में संसाधित हो जाएगा, और आपके उपलब्ध USDT बैलेंस का उपयोग किया जाएगा। सभी संबंधित शुल्कों को कवर करने के लिए पर्याप्त USDT बैलेंस होना ज़रूरी है।
अनुरोध
क्वेरी पैरामीटर
| नाम | पैरामीटर प्रकार | डिफ़ॉल्ट मान | परिभाषा |
|---|---|---|---|
| amount* | string | भुगतान राशि | |
| currency* | string | भुगतान के लिए मुद्रा कोडयदि मुद्रा फिएट है, तो to_currency पैरामीटर आवश्यक है. | |
| order_id* | stringmin:1max:100alpha_dash | आपके सिस्टम में ऑर्डर आईडीपैरामीटर एक स्ट्रिंग होना चाहिए जिसमें वर्णमाला के अक्षर, संख्याएँ, अंडरस्कोर और डैश शामिल हों। इसमें कोई रिक्त स्थान या विशेष वर्ण नहीं होने चाहिए।व्यापारी भुगतानों में order_id अद्वितीय होना चाहिएजब हमें order_id वाला कोई मौजूदा भुगतान मिलता है, तो हम उसका विवरण लौटा देते हैं, नया भुगतान नहीं बनाया जाएगा. | |
| address* | string | उस वॉलेट का पता जिससे निकासी की जाएगी | |
| is_subtract* | boolean | यह निर्धारित करता है कि निकासी शुल्क कहां काटा जाएगासच - आपके बैलेंस सेगलत - भुगतान राशि से, भुगतान राशि कम कर दी जाएगी | |
| network* | string | ब्लॉकचेन नेटवर्क कोडजब currency/to_currency एक क्रिप्टोकरेंसी हो और उसका केवल एक नेटवर्क हो, उदाहरण के लिए BTC, तो इसकी आवश्यकता नहीं है | |
| url_callback | वह URL जिस पर भुगतान स्थिति वाले वेबहुक भेजे जाएंगे | ||
| to_currency | क्रिप्टोकरेंसी कोड जिसमें भुगतान किया जाएगा। इसका उपयोग तब किया जाता है जब मुद्रा पैरामीटर फ़िएट हो। नीचे दिए गए उदाहरण देखें | ||
| course_source | stringउपलब्ध मान• Binance• BinanceP2p• Exmo• Kucoin | व्यापारी की सेटिंग से मूल्य | वह सेवा जिससे चालान में रूपांतरण के लिए विनिमय दरें ली जाती हैं।यह पैरामीटर केवल तभी लागू होता है जब मुद्रा फिएट हो, अन्यथा डिफ़ॉल्ट मान व्यापारी की सेटिंग से लिया जाता है। |
| from_currency | string | null | निकासी राशि को स्वचालित रूप से परिवर्तित करने और from_currency शेष राशि का उपयोग करने की अनुमति देता है। केवल USDT उपलब्ध है। |
| priority | stringmin: 4max: 11उपलब्ध मान• recommended• economy• high• highest | recommended | निकासी प्राथमिकता चुनने के लिए पैरामीटर। निकासी शुल्क की लागत चयनित पैरामीटर पर निर्भर करती है।यह पैरामीटर केवल BTC, ETH, POLYGON और BSC नेटवर्क का उपयोग करने के मामले में लागू होता है। |
| memo | stringmin: 1max: 30 | TON के लिए अतिरिक्त पहचानकर्ता, किसी विशेष प्राप्तकर्ता या लक्ष्य को निर्दिष्ट करने के लिए उपयोग किया जाता है |
पैरामीटर प्रकार
stringपरिभाषा
भुगतान राशिपैरामीटर प्रकार
stringपरिभाषा
भुगतान के लिए मुद्रा कोडयदि मुद्रा फिएट है, तो to_currency पैरामीटर आवश्यक है.पैरामीटर प्रकार
stringmin:1max:100alpha_dashपरिभाषा
आपके सिस्टम में ऑर्डर आईडीपैरामीटर एक स्ट्रिंग होना चाहिए जिसमें वर्णमाला के अक्षर, संख्याएँ, अंडरस्कोर और डैश शामिल हों। इसमें कोई रिक्त स्थान या विशेष वर्ण नहीं होने चाहिए।व्यापारी भुगतानों में order_id अद्वितीय होना चाहिएजब हमें order_id वाला कोई मौजूदा भुगतान मिलता है, तो हम उसका विवरण लौटा देते हैं, नया भुगतान नहीं बनाया जाएगा.पैरामीटर प्रकार
stringपरिभाषा
उस वॉलेट का पता जिससे निकासी की जाएगीपैरामीटर प्रकार
booleanपरिभाषा
यह निर्धारित करता है कि निकासी शुल्क कहां काटा जाएगासच - आपके बैलेंस सेगलत - भुगतान राशि से, भुगतान राशि कम कर दी जाएगीपैरामीटर प्रकार
stringपरिभाषा
ब्लॉकचेन नेटवर्क कोडजब currency/to_currency एक क्रिप्टोकरेंसी हो और उसका केवल एक नेटवर्क हो, उदाहरण के लिए BTC, तो इसकी आवश्यकता नहीं हैपरिभाषा
वह URL जिस पर भुगतान स्थिति वाले वेबहुक भेजे जाएंगेपरिभाषा
क्रिप्टोकरेंसी कोड जिसमें भुगतान किया जाएगा। इसका उपयोग तब किया जाता है जब मुद्रा पैरामीटर फ़िएट हो। नीचे दिए गए उदाहरण देखेंपैरामीटर प्रकार
string
उपलब्ध मान- Binance- BinanceP2p- Exmo- Kucoinपरिभाषा
वह सेवा जिससे चालान में रूपांतरण के लिए विनिमय दरें ली जाती हैं।यह पैरामीटर केवल तभी लागू होता है जब मुद्रा फिएट हो, अन्यथा डिफ़ॉल्ट मान व्यापारी की सेटिंग से लिया जाता है।पैरामीटर प्रकार
stringपरिभाषा
निकासी राशि को स्वचालित रूप से परिवर्तित करने और from_currency शेष राशि का उपयोग करने की अनुमति देता है। केवल USDT उपलब्ध है।पैरामीटर प्रकार
stringmin: 4max: 11
उपलब्ध मान- recommended- economy- high- highestपरिभाषा
निकासी प्राथमिकता चुनने के लिए पैरामीटर। निकासी शुल्क की लागत चयनित पैरामीटर पर निर्भर करती है।यह पैरामीटर केवल BTC, ETH, POLYGON और BSC नेटवर्क का उपयोग करने के मामले में लागू होता है।पैरामीटर प्रकार
stringmin: 1max: 30परिभाषा
TON के लिए अतिरिक्त पहचानकर्ता, किसी विशेष प्राप्तकर्ता या लक्ष्य को निर्दिष्ट करने के लिए उपयोग किया जाता है
* - अनिवार्य पैरामीटर
अनुरोध उदाहरण
curl https://api.cryptomus.com/v1/payout \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"amount": "5",
"currency": "USDT",
"network": "TRON",
"order_id": "1",
"address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
"url_callback": "https://your.site/callback",
"is_subtract": "1",
}'
प्रतिक्रिया
प्रतिक्रिया पैरामीटर
| नाम | परिभाषा |
|---|---|
| uuid | भुगतान का यूयूआईडी |
| amount | भुगतान राशि मुद्रा में |
| currency | भुगतान के लिए मुद्रा कोड |
| network | ब्लॉकचेन नेटवर्क का कोड जिसमें भुगतान किया जाता है |
| address | उस वॉलेट का पता जिस पर भुगतान किया जाता है |
| txid | ब्लॉकचेन में लेनदेन आईडी |
| status | भुगतान स्थिति सभी उपलब्ध स्थितियाँ देखें |
| is_final | क्या भुगतान अंतिम रूप से हो गया हैभुगतान प्रक्रिया को सफलतापूर्वक भुगतान हो जाने पर या विफल होने पर अंतिम माना जाता है। भुगतान विफल होने की स्थिति में, धनराशि आपके बैलेंस में वापस कर दी जाएगी, जिसके लिए आपको भुगतान प्रक्रिया फिर से शुरू करनी होगी। |
| balance | व्यापारी के बैलेंस पर शेष धनराशि. |
| payer_currency | वह क्रिप्टोकरेंसी कोड जिसमें भुगतान वास्तव में किया जाएगा। भुगतान पता भुगतान मुद्रा प्राप्त करेगा। |
| payer_amount | भुगतान की राशि भुगतानकर्ता_मुद्रा में. |
परिभाषा
भुगतान का यूयूआईडीपरिभाषा
भुगतान राशि मुद्रा मेंपरिभाषा
भुगतान के लिए मुद्रा कोडपरिभाषा
ब्लॉकचेन नेटवर्क का कोड जिसमें भुगतान किया जाता हैपरिभाषा
उस वॉलेट का पता जिस पर भुगतान किया जाता हैपरिभाषा
ब्लॉकचेन में लेनदेन आईडीपरिभाषा
भुगतान स्थिति सभी उपलब्ध स्थितियाँ देखेंपरिभाषा
क्या भुगतान अंतिम रूप से हो गया हैभुगतान प्रक्रिया को सफलतापूर्वक भुगतान हो जाने पर या विफल होने पर अंतिम माना जाता है। भुगतान विफल होने की स्थिति में, धनराशि आपके बैलेंस में वापस कर दी जाएगी, जिसके लिए आपको भुगतान प्रक्रिया फिर से शुरू करनी होगी।परिभाषा
व्यापारी के बैलेंस पर शेष धनराशि.परिभाषा
वह क्रिप्टोकरेंसी कोड जिसमें भुगतान वास्तव में किया जाएगा। भुगतान पता भुगतान मुद्रा प्राप्त करेगा।परिभाषा
भुगतान की राशि भुगतानकर्ता_मुद्रा में.
प्रतिक्रिया उदाहरण
1{
2 "state": 0,
3 "result": {
4 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
5 "amount": "3",
6 "currency": "USDT",
7 "network": "TRON",
8 "address": "TJ...",
9 "txid": null,
10 "status": "process",
11 "is_final": false,
12 "balance": 129,
13 "payer_currency": "USD",
14 "payer_amount": 3
15 }
16}
17संभावित त्रुटियाँ
सत्यापन त्रुटियाँ
कोड : 422
उदाहरण प्रतिक्रियाएँ:
1{
2 "state": 1,
3 "errors": {
4 "amount": ["validation.required"]
5 }
6}अगर आपके व्यापारी या उपयोगकर्ता पर भुगतान अवरुद्ध है, तो आपको यह त्रुटि संदेश प्राप्त होगा। उदाहरण के लिए, ऐसा तब होता है जब आप अपना पासवर्ड बदलते हैं और भुगतान 24 घंटे के लिए अवरुद्ध हो जाता है।
1{
2 "state": 1,
3 "message": "You are forbidden"
4}यदि हम मुद्रा पैरामीटर में आपके द्वारा प्रदान किए गए मुद्रा कोड का समर्थन नहीं करते हैं, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "The currency was not found"
4}अगर हमें भुगतान करने के लिए सेवा नहीं मिलती है, तो आपको यह त्रुटि संदेश प्राप्त होगा। आपको यह सुनिश्चित करना होगा कि क्रिप्टोकरेंसी समर्थित है। दर्ज किए गए मानों की शुद्धता की जाँच करें: currency, network, from_currency, to_currency:
1{
2 "state": 1,
3 "message": "The service was not found"
4}यदि निकासी राशि बहुत छोटी है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "The withdrawal amount is too small"
4}यदि आपके पास भुगतान की क्रिप्टोकरेंसी वाला कोई सक्रिय व्यापारी वॉलेट नहीं होगा, तो आपको यह त्रुटि प्राप्त होगी:
1{
2 "state": 1,
3 "message": "Wallet not found"
4}यदि सभी कमीशन सहित भुगतान राशि आपकी शेष राशि से अधिक है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Not enough funds"
4}यदि हमें to_currency पैरामीटर में पास की गई मुद्रा की भुगतान सेवा नहीं मिलती है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Not found service to_currency"
4}यदि to_currency में परिवर्तित करते समय गलती से कुछ हो जाता है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Error convert to_currency"
4}यदि भुगतान राशि क्रिप्टोकरेंसी के लिए न्यूनतम समर्थित राशि से कम है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Minimum amount 0.5 USDT"
4}यदि भुगतान राशि क्रिप्टोकरेंसी के लिए अधिकतम समर्थित राशि से अधिक है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Maximum amount 10000000 USDT"
4}यदि आपके पास भुगतान करने के लिए पर्याप्त धनराशि नहीं है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Not enough funds"
4}यदि आपके पास भुगतान राशि को from_currency में परिवर्तित करने के लिए पर्याप्त धनराशि नहीं है, तो आपको यह त्रुटि संदेश प्राप्त होगा:
1{
2 "state": 1,
3 "message": "Not enough balance for convert USDT to LTC"
4}यदि तकनीकी कार्य होता है और भुगतान अस्थायी रूप से अनुपलब्ध है, तो आपको यह त्रुटि संदेश प्राप्त होगा
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}आंतरिक सर्वर त्रुटि
कोड : 500
उदाहरण प्रतिक्रियाएँ:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}