Қайталанатын төлем жасау

Криптофильмдегі қайталанатын төлемдер - сандық активтерді қолдана отырып, тұрақты транзакцияларды автоматтандыру тәсілі. Олар жазылымға негізделген қызметтер, қайырымдылық, мүшелік және басқа да қайталанатын төлемдер үшін пайдалы болуы мүмкін.

Қайталанатын төлемдерді пайдалану үшін төлемдердің мөлшерін, валютасын және жиілігін анықтайтын төлем жасау керек, содан кейін оны төлеушілермен бөлісу керек. Төлеуші ​​төлем жоспарын растау және алғашқы төлем жасау үшін кіретін криптомистік веб-сайтқа қайта бағытталады. Осыдан кейін төлемдер жоспарға сәйкес автоматты түрде жүзеге асырылады.


post
https://api.cryptomus.com/v1/recurrence/create
Еліктеу

Өтініш

Сұрау параметрлері

ЕсімПараметр түріӘдепкі мәнАнықтама
amount*stringҚайталанатын төлем сомасы
currency*stringВалюта кодексі
name*stringmin:3max:60Қайталанатын төлем атауы
period*stringҚайталанатын төлем мерзіміқолжетімді:weeklymonthlythree_month
to_currencyТөлемдерді қабылдау үшін валюталық кодПараметр қайталанатын төлем сомасын айырбастау үшін мақсатты валютаны анықтау үшін қолданылады.Мысалы, Bitcoin-да 20 долларға қайталанатын төлем жасау:
amount:20
currency: USD
to_currency : btcAPI ағымдағы бағам бойынша BTC-дегі 20 доллар сомасын баламасына айырбастайды және пайдаланушы BTC-де төлейді to_currency әрқашан Fiat валюта коды емес, криптошталдық коды болуы керек.
order_idstringmin:1max:100nullСіздің жүйеңіздегі идентификатор
url_callbackurlnullТөлем мәртебесі бар веб-үйге жіберілетін URL мекенжайы
discount_daysintegermin:1max:3650Жеңілдік кезеңдері («жеңілдіктермен» талап етіледі)
discount_amountstringnullЖеңілдік сомасы («жеңілдіктермен» талап етіледі). Мұнда «валюта» параметрінің валютасындағы сома
additional_datastringnullҚосымша қайталанатын төлем туралы мәліметтер

Параметр түрі

string

Анықтама

Қайталанатын төлем сомасы

Параметр түрі

string

Анықтама

Валюта кодексі

Параметр түрі

stringmin:3max:60

Анықтама

Қайталанатын төлем атауы

Параметр түрі

string

Анықтама

Қайталанатын төлем мерзіміқолжетімді:weeklymonthlythree_month

Анықтама

Төлемдерді қабылдау үшін валюталық кодПараметр қайталанатын төлем сомасын айырбастау үшін мақсатты валютаны анықтау үшін қолданылады.Мысалы, Bitcoin-да 20 долларға қайталанатын төлем жасау:
amount:20
currency: USD
to_currency : btcAPI ағымдағы бағам бойынша BTC-дегі 20 доллар сомасын баламасына айырбастайды және пайдаланушы BTC-де төлейді to_currency әрқашан Fiat валюта коды емес, криптошталдық коды болуы керек.

Параметр түрі

stringmin:1max:100

Анықтама

Сіздің жүйеңіздегі идентификатор

Параметр түрі

url

Анықтама

Төлем мәртебесі бар веб-үйге жіберілетін URL мекенжайы

Параметр түрі

integermin:1max:365

Анықтама

Жеңілдік кезеңдері («жеңілдіктермен» талап етіледі)

Параметр түрі

string

Анықтама

Жеңілдік сомасы («жеңілдіктермен» талап етіледі). Мұнда «валюта» параметрінің валютасындағы сома

Параметр түрі

string

Анықтама

Қосымша қайталанатын төлем туралы мәліметтер

* - Міндетті параметр

Жеңілдік:

Күндердегі бірінші кезең ( discount_days параметрі), ол басқа мөлшерге, оның ішінде ( discount_amount параметр). Мысалы, discount_amount орната аласыз, алғашқы 30 күн және ай сайынғы кезең ішінде, содан кейін пайдаланушы алғашқы төлемді төменгі бағамен төлейді, екінші және кейінгі төлемдер толық бағамен төленеді.

Жеңілдік сомасы «Валюта» параметрімен көрсетілген валютада болуы керек.

Мысал сұрау

Төменде үлгі болып табылады, бұл жағдайда қажетті параметрлер саны, бұл жағдайда талап етілетін, Fiat валютасы АҚШ долларымен шот-фактура жасалады. Төлем бетіне пайдаланушы осы шотты төлеу үшін CREPTocurrence және желіні таңдай алады.


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Қайталанатын uuid
nameҚайталанатын есім
order_idСіздің жүйеңіздегі идентификатор
amountҚайталанатын сома
currencyВалюта кодексі
payer_currencyТапсырыс беруші төлем жасауы керек валютасы.
payer_amount_usd payer_currency үшін балама доллар сомасы
payer_amount payer_currency ішіндегі сома, мен тапсырыс беруші төлеуі керек
url_callbackТөлем мәртебесі бар веб-үйге жіберілетін URL мекенжайы
periodҚайталанатын төлем мерзімі
statusҚайталанатын мәртебеҚол жетімді опциялар:• wait_accept• cancel_by_merchant• active• cancel_by_user
urlТөлеуші ​​төлем жасайтын криптомустың төлем парағының URL мекенжайы
last_pay_offСоңғы төлем күні. Уақыт белдеуі UTC + 3. Егер мән NULL болса, төлемдер жоқ.
additional_dataҚосымша қайталанатын төлем туралы мәліметтер

Анықтама

Қайталанатын uuid

Анықтама

Қайталанатын есім

Анықтама

Сіздің жүйеңіздегі идентификатор

Анықтама

Қайталанатын сома

Анықтама

Валюта кодексі

Анықтама

Тапсырыс беруші төлем жасауы керек валютасы.

Анықтама

payer_currency үшін балама доллар сомасы

Анықтама

payer_currency ішіндегі сома, мен тапсырыс беруші төлеуі керек

Анықтама

Төлем мәртебесі бар веб-үйге жіберілетін URL мекенжайы

Анықтама

Қайталанатын төлем мерзімі

Анықтама

Қайталанатын мәртебеҚол жетімді опциялар:- wait_accept- cancel_by_merchant- active- cancel_by_user

Анықтама

Төлеуші ​​төлем жасайтын криптомустың төлем парағының URL мекенжайы

Анықтама

Соңғы төлем күні. Уақыт белдеуі UTC + 3. Егер мән NULL болса, төлемдер жоқ.

Анықтама

Қосымша қайталанатын төлем туралы мәліметтер

Жауаптың мысалы

Егер сұрау сәтті болса. Жауап коды - 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 АҚШ долларына қайталануды төлеу үшін мәліметтер мысалын сұраңыз


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 АҚШ доллары үшін қайталануды төлеу үшін мәліметтерді сұраңыз және тек 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}
Еліктеу