Төлем тарихы

post https://api.cryptomus.com/v1/payout/list Көшіру

Өтініш

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

ЕсімПараметр түріӘдепкі мәнАнықтама
date_fromstringformat: YYYY-MM-DD H:mm:ssnullЖасалған күн бойынша сүзу, одан
date_tostringformat: YYYY-MM-DD H:mm:ssnullЖасалған күн бойынша сүзу,

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

stringformat: YYYY-MM-DD H:mm:ss

Әдепкі мән

null

Анықтама

Жасалған күн бойынша сүзу, одан

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

stringformat: YYYY-MM-DD H:mm:ss

Әдепкі мән

null

Анықтама

Жасалған күн бойынша сүзу,

Мысал сұрау


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' 
Көшіру

Жасалған күнмен 4 мамырдан 16 мамырға дейін төлемдерді сүзу.


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
	"date_from": "2023-05-04 00:00:00",
	"date_to": "2023-05-16 23:59:59"
}'
Көшіру

Жауап

Жауап параметрлері

ЕсімПараметр түріАнықтама
merchant_uuidstringКөпес ууид
itemsТөлемдер массиві. Құрылым
paginateКәмелетке толмағандар туралы мәліметтер. Құрылым

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

string

Анықтама

Көпес ууид

Анықтама

Төлемдер массиві. Құрылым

Анықтама

Кәмелетке толмағандар туралы мәліметтер. Құрылым

Құрылымы зат

ЕсімПараметр түріАнықтама
uuidstringТөлемнің ууидері
amountstringТөлем сомасы currency
currencystringТөлемге арналған валюталық код
networkstring|nullТөлем жасалатын блок-жабық желінің коды
payer_currencystring|nullТөлем жасалған криптошалық коды іс жүзінде жасалады. Төлем мекен-жайы төлем валютасын алады.
payer_amountstring|null Төлеуші_курсиялық төлемін құрайды.
addressstringТөлем жасалған әмиянның мекен-жайы
txidstring|nullБояудағы транзакция идентификаторы
statusstringТөлем мәртебесі Күту
payment_statusstringТөлем мәртебесі
is_finalbooleanТөлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады.
balancestring|nullСаудагердің әмиянындағы қалған қаражат.
order_idstring|nullСіздің жүйеңіздегі идентификатор
commissionstring|nullCryptomus комиссиясының сомасы
merchant_amountstring|nullСаудагердің балансынан, соның ішінде барлық комиссиялардан есептен шығарылған сома.
created_atstring|nullТөлемнің құрылған күні. TimeZone - UTC + 3
updated_atstring|nullСоңғы төлем жаңартылған күні. TimeZone - UTC + 3
convertТөлем автоматты түрде айырбасталатын валюта туралы ақпарат. Айырбастау Payer_currency USDT-тен орындаладыЕгер from_currency мәні берілген болса, көрсетіңіз
convert.to_currencystring|nullТөлем болып айырылған валюта коды
convert.from_currencystringВалютаның
convert.commissionstringАйырбастау жарнасы
convert.ratestring|nullАйырбастау бағамы
convert.from_amountstring|nullСома

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

string

Анықтама

Төлемнің ууидері

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

string

Анықтама

Төлем сомасы currency

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

string

Анықтама

Төлемге арналған валюталық код

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

string|null

Анықтама

Төлем жасалатын блок-жабық желінің коды

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

string|null

Анықтама

Төлем жасалған криптошалық коды іс жүзінде жасалады. Төлем мекен-жайы төлем валютасын алады.

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

string|null

Анықтама

Төлеуші_курсиялық төлемін құрайды.

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

string

Анықтама

Төлем жасалған әмиянның мекен-жайы

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

string|null

Анықтама

Бояудағы транзакция идентификаторы

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

string

Анықтама

Төлем мәртебесі Күту

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

string

Анықтама

Төлем мәртебесі

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

boolean

Анықтама

Төлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады.

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

string|null

Анықтама

Саудагердің әмиянындағы қалған қаражат.

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

string|null

Анықтама

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

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

string|null

Анықтама

Cryptomus комиссиясының сомасы

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

string|null

Анықтама

Саудагердің балансынан, соның ішінде барлық комиссиялардан есептен шығарылған сома.

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

string|null

Анықтама

Төлемнің құрылған күні. TimeZone - UTC + 3

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

string|null

Анықтама

Соңғы төлем жаңартылған күні. TimeZone - UTC + 3

Анықтама

Төлем автоматты түрде айырбасталатын валюта туралы ақпарат. Айырбастау Payer_currency USDT-тен орындаладыЕгер from_currency мәні берілген болса, көрсетіңіз

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

string|null

Анықтама

Төлем болып айырылған валюта коды

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

string

Анықтама

Валютаның

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

string

Анықтама

Айырбастау жарнасы

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

string|null

Анықтама

Айырбастау бағамы

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

string|null

Анықтама

Сома
Келесі / алдыңғы бет жазбаларын алу үшін, сұрау параметрлеріндегі келесі / алдыңғы жүгіргіні көрсетіңіз (?cursor=nextCursorHash)

Мысал:


1curl https://api.cryptomus.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6
Көшіру

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


1{
2"state": 0,
3"result": {
4	"merchant_uuid": "8b03432e-385b-4670-8d06-064591096795",
5	"items": [{
6		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
7		"amount": "3",
8		"currency": "USDT",
9		"network": "TRON",
10		"payer_currency": "USDT",
11		"payer_amount": "3",
12		"address": "TJ...",
13		"txid": null,
14		"status": "process",
15		"payment_status": "process",
16		"is_final": false,
17		"balance": "129.00000000",
18		"order_id": "1",
19		"commission": null,
20		"merchant_amount": null,
21		"created_at": "2023-06-21T17:25:55+03:00",
22		"updated_at": "2023-06-21T17:34:38+03:00"
23	}, {
24		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
25		"amount": "5.40000000",
26		"currency": "DOGE",
27		"network": "doge",
28		"payer_currency": "DOGE",
29		"payer_amount": "5.40000000",
30		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
31		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
32		"status": "paid",
33		"payment_status": "paid",
34		"is_final": true,
35		"balance": "26.77966652",
36		"order_id": null,
37		"commission": "0.00000000",
38		"merchant_amount": "5.40000000",
39		"created_at": "2023-07-21T17:25:55+03:00",
40		"updated_at": "2023-07-21T17:34:38+03:00"
41	},
42	...
43	],
44	"paginate": {
45		"count": 15,
46		"hasPages": true,
47		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
48		"previousCursor": null,
49		"perPage": 15
50	}
51}
52}
Көшіру

Мүмкін қателер

Тексеру қателері

код : 422

мысал жауаптары:

Егер Date_from немесе Date_to параметрі дұрыс емес форматта берілсе.


1{
2	"state": 1,
3	"errors": {
4	"date_from": ["validation.regex"]
5	}
6}
Көшіру