आवर्ती भुगतान बनाना
क्रिप्टोकरेंसी में आवर्ती भुगतान, डिजिटल संपत्तियों का उपयोग करके नियमित लेनदेन को स्वचालित करने का एक तरीका है। ये सदस्यता-आधारित सेवाओं, दान, सदस्यता और अन्य आवर्ती भुगतानों के लिए उपयोगी हो सकते हैं।
आवर्ती भुगतानों का उपयोग करने के लिए, आपको एक भुगतान बनाना होगा जिसमें भुगतान की राशि, मुद्रा और आवृत्ति निर्दिष्ट हो, और फिर उसे अपने भुगतानकर्ताओं के साथ साझा करना होगा। भुगतानकर्ता को क्रिप्टोमस वेबसाइट पर पुनः निर्देशित किया जाएगा, जहाँ उसे भुगतान योजना की पुष्टि करने और पहला भुगतान करने के लिए लॉग इन करना होगा। उसके बाद, योजना के अनुसार भुगतान स्वचालित रूप से हो जाएँगे।
अनुरोध
क्वेरी पैरामीटर
| नाम | पैरामीटर प्रकार | डिफ़ॉल्ट मान | परिभाषा |
|---|---|---|---|
| amount* | string | - | आवर्ती भुगतान राशि |
| currency* | string | - | मुद्रा कोड |
| name* | stringmin:3max:60 | - | आवर्ती भुगतान का नाम |
| period* | string | - | आवर्ती भुगतान अवधिउपलब्ध:weeklymonthlythree_month |
| to_currency | - | भुगतान स्वीकार करने के लिए मुद्रा कोडपैरामीटर का उपयोग आवर्ती भुगतान राशि को परिवर्तित करने के लिए लक्ष्य मुद्रा निर्दिष्ट करने के लिए किया जाता है।उदाहरण के लिए, बिटकॉइन में 20 USD के लिए आवर्ती भुगतान बनाने के लिए: राशि: 20 मुद्रा: USD to_currency: BTCएपीआई वर्तमान विनिमय दर के आधार पर 20 USD राशि को उसके समतुल्य BTC में परिवर्तित कर देगा और उपयोगकर्ता BTC में भुगतान करेगाto_currency हमेशा क्रिप्टोकरेंसी कोड होना चाहिए, न कि फिएट करेंसी कोड। | |
| order_id | stringmin:1max:100 | null | आपके सिस्टम में ऑर्डर आईडी |
| url_callback | url | null | वह URL जिस पर भुगतान स्थिति वाले वेबहुक भेजे जाएंगे |
| discount_days | integermin:1max:365 | 0 | छूट अवधि के दिन ('discount_amount' के साथ आवश्यक) |
| discount_amount | string | null | छूट राशि ('discount_days' के साथ आवश्यक). यहाँ पैरामीटर 'मुद्रा' की मुद्रा में राशि |
| additional_data | string | null | अतिरिक्त आवर्ती भुगतान विवरण |
पैरामीटर प्रकार
stringपरिभाषा
आवर्ती भुगतान राशिपैरामीटर प्रकार
stringपरिभाषा
मुद्रा कोडपैरामीटर प्रकार
stringmin:3max:60परिभाषा
आवर्ती भुगतान का नामपैरामीटर प्रकार
stringपरिभाषा
आवर्ती भुगतान अवधिउपलब्ध:weeklymonthlythree_monthपरिभाषा
भुगतान स्वीकार करने के लिए मुद्रा कोडपैरामीटर का उपयोग आवर्ती भुगतान राशि को परिवर्तित करने के लिए लक्ष्य मुद्रा निर्दिष्ट करने के लिए किया जाता है।उदाहरण के लिए, बिटकॉइन में 20 USD के लिए आवर्ती भुगतान बनाने के लिए:
राशि: 20
मुद्रा: USD
to_currency: BTCएपीआई वर्तमान विनिमय दर के आधार पर 20 USD राशि को उसके समतुल्य BTC में परिवर्तित कर देगा और उपयोगकर्ता BTC में भुगतान करेगाto_currency हमेशा क्रिप्टोकरेंसी कोड होना चाहिए, न कि फिएट करेंसी कोड।पैरामीटर प्रकार
stringmin:1max:100डिफ़ॉल्ट मान
nullपरिभाषा
आपके सिस्टम में ऑर्डर आईडीपैरामीटर प्रकार
urlडिफ़ॉल्ट मान
nullपरिभाषा
वह URL जिस पर भुगतान स्थिति वाले वेबहुक भेजे जाएंगेपैरामीटर प्रकार
integermin:1max:365डिफ़ॉल्ट मान
0परिभाषा
छूट अवधि के दिन ('discount_amount' के साथ आवश्यक)पैरामीटर प्रकार
stringडिफ़ॉल्ट मान
nullपरिभाषा
छूट राशि ('discount_days' के साथ आवश्यक). यहाँ पैरामीटर 'मुद्रा' की मुद्रा में राशिपैरामीटर प्रकार
stringडिफ़ॉल्ट मान
nullपरिभाषा
अतिरिक्त आवर्ती भुगतान विवरण
* - अनिवार्य पैरामीटर
छूट:
पहली अवधि दिनों में (discount_days पैरामीटर), जिसकी लागत अलग होगी (discount_amount पैरामीटर)। उदाहरण के लिए, आप पहले 30 दिनों और मासिक अवधि के लिए एक discount_amount निर्धारित कर सकते हैं, फिर उपयोगकर्ता पहला भुगतान कम कीमत पर करेगा, दूसरा और उसके बाद के भुगतान पूरी कीमत पर होंगे।छूट राशि पैरामीटर 'मुद्रा' द्वारा निर्दिष्ट मुद्रा में होनी चाहिए।
अनुरोध उदाहरण
नीचे न्यूनतम आवश्यक मापदंडों के साथ एक नमूना उदाहरण दिया गया है। इस मामले में, एक चालान फ़िएट मुद्रा USD में बनाया जाएगा। भुगतान पृष्ठ पर, उपयोगकर्ता इस बिल का भुगतान करने के लिए क्रिप्टोकरेंसी और नेटवर्क का चयन कर सकेगा।
curl https://api.cryptomus.com/v1/recurrence/create \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"amount": "15",
"currency": "USDT",
"name": "Recurring payment",
"period": "monthly"
}'प्रतिक्रिया
प्रतिक्रिया पैरामीटर
| नाम | परिभाषा |
|---|---|
| uuid | आवर्ती यूयूआईडी |
| name | आवर्ती नाम |
| order_id | आपके सिस्टम में ऑर्डर आईडी |
| amount | आवर्ती राशि |
| currency | मुद्रा कोड |
| payer_currency | वह मुद्रा जिसमें ग्राहक को भुगतान करना होगा। |
| payer_amount_usd | भुगतानकर्ता_मुद्रा में समतुल्य USD राशि जो ग्राहक को चुकानी होगी |
| payer_amount | भुगतानकर्ता_मुद्रा में वह राशि जो ग्राहक को चुकानी होगी |
| url_callback | वह URL जिस पर भुगतान स्थिति वाले वेबहुक भेजे जाएंगे |
| period | आवर्ती भुगतान अवधि |
| status | आवर्ती स्थितिउपलब्ध विकल्प:• wait_accept• cancel_by_merchant• active• cancel_by_user |
| url | क्रिप्टोमस भुगतान पृष्ठ का URL जहाँ भुगतानकर्ता भुगतान करेगा |
| last_pay_off | अंतिम भुगतान की तिथि। समय क्षेत्र UTC+3 है। यदि मान शून्य है, तो कोई भुगतान नहीं किया गया। |
| additional_data | अतिरिक्त आवर्ती भुगतान विवरण |
परिभाषा
आवर्ती यूयूआईडीपरिभाषा
आवर्ती नामपरिभाषा
आपके सिस्टम में ऑर्डर आईडीपरिभाषा
आवर्ती राशिपरिभाषा
मुद्रा कोडपरिभाषा
वह मुद्रा जिसमें ग्राहक को भुगतान करना होगा।परिभाषा
भुगतानकर्ता_मुद्रा में समतुल्य USD राशि जो ग्राहक को चुकानी होगीपरिभाषा
भुगतानकर्ता_मुद्रा में वह राशि जो ग्राहक को चुकानी होगीपरिभाषा
वह URL जिस पर भुगतान स्थिति वाले वेबहुक भेजे जाएंगेपरिभाषा
आवर्ती भुगतान अवधिपरिभाषा
आवर्ती स्थितिउपलब्ध विकल्प:- wait_accept- cancel_by_merchant- active- cancel_by_userपरिभाषा
क्रिप्टोमस भुगतान पृष्ठ का URL जहाँ भुगतानकर्ता भुगतान करेगापरिभाषा
अंतिम भुगतान की तिथि। समय क्षेत्र UTC+3 है। यदि मान शून्य है, तो कोई भुगतान नहीं किया गया।परिभाषा
अतिरिक्त आवर्ती भुगतान विवरण
प्रतिक्रिया उदाहरण
यदि अनुरोध सफल होता है तो प्रतिक्रिया कोड 200 होगा।
1{
2 "state": 0,
3 "result": {
4 "uuid": "afd050e8-35ea-4129-bbdd-73f510dce556",
5 "name": "Recurring payment",
6 "order_id": null,
7 "amount": "15",
8 "currency": "USDT",
9 "payer_currency": "USDT",
10 "payer_amount_usd": "15.00",
11 "payer_amount": "15.00000000",
12 "url_callback": null,
13 "period": "monthly",
14 "status": "wait_accept",
15 "url": "https://pay.cryptomus.com/recurring/afd050e8-35ea-4129-bbdd-73f510dce556",
16 "last_pay_off": null
17 }
18}और ज्यादा उदाहरण
15 USD का पुनरावर्ती भुगतान बनाने के लिए डेटा उदाहरण का अनुरोध करें
1{
2 "amount": "15",
3 "currency": "USD",
4 "name": "Recurring payment",
5 "period": "monthly",
6 "url_callback": "https://your.site/callback"
7}प्रतिक्रिया उदाहरण:
1{
2 "state": 0,
3 "result": {
4 "uuid": "1d4c1ef7-1dcd-4f98-9433-2e19d2e62820",
5 "name": "Recurring payment",
6 "order_id": null,
7 "amount": "15",
8 "currency": "USD",
9 "payer_currency": null,
10 "payer_amount_usd": "0.00",
11 "payer_amount": null,
12 "url_callback": "https://your.site/callback",
13 "period": "monthly",
14 "status": "wait_accept",
15 "url": "https://pay.cryptomus.com/recurring/1d4c1ef7-1dcd-4f98-9433-2e19d2e62820",
16 "last_pay_off": null
17 }
18}15 USDT के लिए पुनरावर्ती भुगतान बनाने हेतु डेटा उदाहरण का अनुरोध करें (भुगतान के लिए केवल USDT की अनुमति होगी)
1{
2 "amount": "15",
3 "currency": "USDT",
4 "name": "Recurring payment",
5 "period": "monthly",
6 "url_callback": "https://your.site/callback"
7}प्रतिक्रिया उदाहरण:
1{
2 "state": 0,
3 "result": {
4 "uuid": "ec04dc64-fea4-445a-9698-59baa474317a",
5 "name": "Recurring payment",
6 "order_id": null,
7 "amount": "15",
8 "currency": "USDT",
9 "payer_currency": "USDT",
10 "payer_amount_usd": "15.00",
11 "payer_amount": "15.00000000",
12 "url_callback": "https://your.site/callback",
13 "period": "monthly",
14 "status": "wait_accept",
15 "url": "https://pay.cryptomus.com/recurring/ec04dc64-fea4-445a-9698-59baa474317a",
16 "last_pay_off": null
17 }
18}15 USD का पुनरावर्ती भुगतान बनाने और भुगतान के लिए केवल BTC मुद्रा की अनुमति देने के लिए डेटा उदाहरण का अनुरोध करें
1{
2 "amount": "15",
3 "currency": "USD",
4 "to_currency": "BTC",
5 "name": "Recurring payment",
6 "period": "monthly",
7 "url_callback": "https://your.site/callback"
8}प्रतिक्रिया उदाहरण:
1{
2 "state": 0,
3 "result": {
4 "uuid": "e7d9c265-3849-4ff8-84c1-15435368f05f",
5 "name": "Recurring payment",
6 "order_id": null,
7 "amount": "15",
8 "currency": "USD",
9 "payer_currency": "BTC",
10 "payer_amount_usd": "15.00",
11 "payer_amount": "0.00051495",
12 "url_callback": "https://your.site/callback",
13 "period": "monthly",
14 "status": "wait_accept",
15 "url": "https://pay.cryptomus.com/recurring/e7d9c265-3849-4ff8-84c1-15435368f05f",
16 "last_pay_off": null
17 }
18}$15 की राशि का आवर्ती भुगतान बनाने के लिए डेटा उदाहरण का अनुरोध करें। पहले 30 दिनों के लिए कीमत $1 होगी, उसके बाद - $15:
1{
2 "amount": "15",
3 "currency": "USD",
4 "name": "Recurring payment",
5 "period": "monthly",
6 "discount_days": 30,
7 "discount_amount": "1"
8 "url_callback": "https://your.site/callback"
9}प्रतिक्रिया उदाहरण:
1{
2 "state": 0,
3 "result": {
4 "uuid": "1ee00fbd-42e7-4653-b316-1ab12f8a447b",
5 "name": "Recurring payment",
6 "order_id": null,
7 "amount": "15",
8 "currency": "USD",
9 "payer_currency": null,
10 "payer_amount_usd": "0.00",
11 "payer_amount": null,
12 "url_callback": "https://your.site/callback",
13 "discount_days": "30",
14 "discount_amount": "1",
15 "end_of_discount": "2023-07-11T20:23:52+03:00",
16 "period": "monthly",
17 "status": "wait_accept",
18 "url": "https://pay.cryptomus.com/recurring/1ee00fbd-42e7-4653-b316-1ab12f8a447b",
19 "last_pay_off": null
20 }
21}