Төлем тарихы
post https://api.cryptomus.com/v1/payout/list Көшіру
Өтініш
Сұрау параметрлері
| Есім | Параметр түрі | Әдепкі мән | Анықтама |
|---|---|---|---|
| date_from | stringformat: YYYY-MM-DD H:mm:ss | null | Жасалған күн бойынша сүзу, одан |
| date_to | stringformat: YYYY-MM-DD H:mm:ss | null | Жасалған күн бойынша сүзу, |
Параметр түрі
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_uuid | string | Көпес ууид |
| items | Төлемдер массиві. Құрылым | |
| paginate | Кәмелетке толмағандар туралы мәліметтер. Құрылым |
Параметр түрі
stringАнықтама
Көпес ууид
Құрылымы зат
| Есім | Параметр түрі | Анықтама |
|---|---|---|
| uuid | string | Төлемнің ууидері |
| amount | string | Төлем сомасы currency |
| currency | string | Төлемге арналған валюталық код |
| network | string|null | Төлем жасалатын блок-жабық желінің коды |
| payer_currency | string|null | Төлем жасалған криптошалық коды іс жүзінде жасалады. Төлем мекен-жайы төлем валютасын алады. |
| payer_amount | string|null | Төлеуші_курсиялық төлемін құрайды. |
| address | string | Төлем жасалған әмиянның мекен-жайы |
| txid | string|null | Бояудағы транзакция идентификаторы |
| status | string | Төлем мәртебесі Күту |
| payment_status | string | Төлем мәртебесі |
| is_final | boolean | Төлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады. |
| balance | string|null | Саудагердің әмиянындағы қалған қаражат. |
| order_id | string|null | Сіздің жүйеңіздегі идентификатор |
| commission | string|null | Cryptomus комиссиясының сомасы |
| merchant_amount | string|null | Саудагердің балансынан, соның ішінде барлық комиссиялардан есептен шығарылған сома. |
| created_at | string|null | Төлемнің құрылған күні. TimeZone - UTC + 3 |
| updated_at | string|null | Соңғы төлем жаңартылған күні. TimeZone - UTC + 3 |
| convert | Төлем автоматты түрде айырбасталатын валюта туралы ақпарат. Айырбастау Payer_currency USDT-тен орындаладыЕгер from_currency мәні берілген болса, көрсетіңіз | |
| convert.to_currency | string|null | Төлем болып айырылған валюта коды |
| convert.from_currency | string | Валютаның |
| convert.commission | string | Айырбастау жарнасы |
| convert.rate | string|null | Айырбастау бағамы |
| convert.from_amount | string|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}Көшіру