Takrorlanadigan to'lovni yaratish

Kriptocurringsda takrorlanadigan to'lov raqamli aktivlardan foydalangan holda doimiy operatsiyalarni avtomatlashtirish yo'lidir. Ular obuna xizmatlari, xayr-ehsonlar, a'zolik va boshqa takroriy to'lovlar uchun foydali bo'lishi mumkin.

Takroriy to'lovlardan foydalanish uchun siz to'lovlarning miqdori, valyutasi va chastotasi ko'rsatilgan to'lovni yaratishingiz va keyin uni to'lovchilar bilan baham ko'rishingiz kerak. To'lovchining kriptosus veb-saytiga yo'naltiriladi, u erda to'lov rejasini tasdiqlash va birinchi to'lovni amalga oshirish uchun tizimga kirish kerak bo'ladi. Shundan so'ng, to'lovlar avtomatik ravishda rejaga muvofiq amalga oshiriladi.

post

https://api.cryptomus.com/v1/recurrence/create

Nusxa ko'chirmoq

Talab qilmoq

So'rov parametrlari

Ism	Parametr turi	Standart qiymat	Ta'rif
amount*	string		Takrorlanuvchi to'lov miqdori
currency*	string		Valyuta kodi
name*	stringmin:3max:60		Qayta tiklanadigan to'lov nomi
period*	string		Qayta takrorlanadigan to'lov davrimavjud:weeklymonthlythree_month
to_currency			To'lovlarni qabul qilish uchun valyuta kodiParametr takroriy to'lov miqdorini almashtirish uchun maqsadli valyutani belgilash uchun ishlatiladi.Masalan, Bitcoin-da 20 AQSh dollari uchun takrorlanadigan to'lovni yaratish: amount:20 currency to_currency : BTCAPI 20 AQSh dollari miqdorini BTCda joriy ayirboshlash kursi asosida va foydalanuvchi BTCda to'laydi to_currency har doim Fiat valyuta kodi emas, balki CryptoSurrencection Kodeksi bo'lishi kerak.
order_id	stringmin:1max:100	null	Tizimingizda buyurtma identifikatori
url_callback	url	null	To'lov holati bilan qaysi WebHook yuboriladi
discount_days	integermin:1max:365	0	Chegirma muddati ('chegirma_amunt) bilan talab qilinadi)
discount_amount	string	null	Chegirma miqdori ('chegirma_ kunlar) bilan talab qilinadi). Bu erda parametr parametridagi "valyuta" valyutasida
additional_data	string	null	Qo'shimcha takrorlanadigan to'lov tafsilotlari

Parametr turi

string

Ta'rif

Takrorlanuvchi to'lov miqdori

Parametr turi

string

Ta'rif

Valyuta kodi

Parametr turi

stringmin:3max:60

Ta'rif

Qayta tiklanadigan to'lov nomi

Parametr turi

string

Ta'rif

Qayta takrorlanadigan to'lov davrimavjud:weeklymonthlythree_month

Ta'rif

To'lovlarni qabul qilish uchun valyuta kodiParametr takroriy to'lov miqdorini almashtirish uchun maqsadli valyutani belgilash uchun ishlatiladi.Masalan, Bitcoin-da 20 AQSh dollari uchun takrorlanadigan to'lovni yaratish:
amount:20
currency
to_currency : BTCAPI 20 AQSh dollari miqdorini BTCda joriy ayirboshlash kursi asosida va foydalanuvchi BTCda to'laydi to_currency har doim Fiat valyuta kodi emas, balki CryptoSurrencection Kodeksi bo'lishi kerak.

Parametr turi

stringmin:1max:100

Ta'rif

Tizimingizda buyurtma identifikatori

Parametr turi

url

Ta'rif

To'lov holati bilan qaysi WebHook yuboriladi

Parametr turi

integermin:1max:365

Ta'rif

Chegirma muddati ('chegirma_amunt) bilan talab qilinadi)

Parametr turi

string

Ta'rif

Chegirma miqdori ('chegirma_ kunlar) bilan talab qilinadi). Bu erda parametr parametridagi "valyuta" valyutasida

Parametr turi

string

Ta'rif

Qo'shimcha takrorlanadigan to'lov tafsilotlari

* - Majburiy parametr

Chegirma:

Bir necha kun ichida birinchi davr (discount_days parametr), bu har xil miqdordagi ( discount_amount parametriga). Masalan, siz oyda 30 kun va har oyda discount_amount o'rnatishingiz mumkin, shunda foydalanuvchi birinchi to'lovni arzonroq, ikkinchi va keyingi to'lovlar to'liq narxga ega bo'ladi.

Chegirma miqdori parametr parametri tomonidan belgilangan valyutada bo'lishi kerak.

Misolga misol

Quyida bu holda talab qilinadigan minimal parametrlar bo'yicha namunaviy misol keltirilgan, fiat valyuta AQSh dollari bilan schyot-faktura tashkil etiladi. To'lov sahifasida foydalanuvchi ushbu to'lovni to'lash uchun kriptocujlik va tarmoqni tanlashi mumkin.


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"
}'

Nusxa ko'chirmoq

Javob

Javob parametrlari

Ism	Ta'rif
uuid	Takrorlanadigan UUID
name	Qayta ishlaydigan ism
order_id	Tizimingizda buyurtma identifikatori
amount	Takroriy miqdor
currency	Valyuta kodi
payer_currency	Mijoz to'lovni amalga oshirishi kerak bo'lgan valyuta.
payer_amount_usd	Mijoz to'lashi kerak bo'lgan payer_currency ning ekvivalent miqdori
payer_amount	to'lovchi_currenity bu mijoz to'lashi kerak bo'lgan miqdor
url_callback	To'lov holati bilan qaysi WebHook yuboriladi
period	Qayta takrorlanadigan to'lov davri
status	Takrorlanuvchi holatMavjud variantlar:• wait_accept• cancel_by_merchant• active• cancel_by_user
url	Kriptous to'lovi URL manzili qayerda to'lovni amalga oshiradi
last_pay_off	Oxirgi to'lov sanasi. Vaqt zonasi - UTC + 3. Agar qiymat nol bo'lsa, to'lovlar amalga oshirilmadi.
additional_data	Qo'shimcha takrorlanadigan to'lov tafsilotlari

: Ta'rif
Takrorlanadigan UUID
: Ta'rif
Qayta ishlaydigan ism
: Ta'rif
Tizimingizda buyurtma identifikatori
: Ta'rif
Takroriy miqdor
: Ta'rif
Valyuta kodi
: Ta'rif
Mijoz to'lovni amalga oshirishi kerak bo'lgan valyuta.
: Ta'rif
Mijoz to'lashi kerak bo'lgan payer_currency ning ekvivalent miqdori
: Ta'rif
to'lovchi_currenity bu mijoz to'lashi kerak bo'lgan miqdor
: Ta'rif
To'lov holati bilan qaysi WebHook yuboriladi
: Ta'rif
Qayta takrorlanadigan to'lov davri
: Ta'rif
Takrorlanuvchi holatMavjud variantlar:- wait_accept- cancel_by_merchant- active- cancel_by_user
: Ta'rif
Kriptous to'lovi URL manzili qayerda to'lovni amalga oshiradi
: Ta'rif
Oxirgi to'lov sanasi. Vaqt zonasi - UTC + 3. Agar qiymat nol bo'lsa, to'lovlar amalga oshirilmadi.
: Ta'rif
Qo'shimcha takrorlanadigan to'lov tafsilotlari

Javob namunasi

Agar so'rov muvaffaqiyatli bo'lsa. Javob kodi 200 ga teng.


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}

Nusxa ko'chirmoq

Boshqa misollar

11 AQSh dollari uchun takrorlanadigan to'lovni yaratish uchun ma'lumotlar misolini talab qiling


1{
2	"amount": "15",
3	"currency": "USD",
4	"name": "Recurring payment",
5	"period": "monthly",
6	"url_callback": "https://your.site/callback"
7}

Nusxa ko'chirmoq

Javob namunasi:


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}

Nusxa ko'chirmoq

15 USDT uchun qayta taqsimlash to'lovini yaratish uchun ma'lumotlar misolini talab qilish (faqat AQSh dollariga to'g'ri keladi)


1{
2	"amount": "15",
3	"currency": "USDT",
4	"name": "Recurring payment",
5	"period": "monthly",
6	"url_callback": "https://your.site/callback"
7}

Nusxa ko'chirmoq

Javob namunasi:


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}

Nusxa ko'chirmoq

15 AQSh dollari uchun takrorlanish to'lovini yaratish va to'lov uchun faqat BTC valyutasini berish uchun ma'lumotlarning misolini talab qilish


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}

Nusxa ko'chirmoq

Javob namunasi:


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}

Nusxa ko'chirmoq

$ 15 miqdorida takroriy to'lovni yaratish uchun ma'lumotlar misolini talab qiling. Dastlabki 30 kunlik narx 1 dollarni tashkil etadi, shundan so'ng - $ 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}

Nusxa ko'chirmoq

Javob namunasi:


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}

Nusxa ko'chirmoq