Төлем тарихы
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Анықтама
Жасалған күн бойынша сүзу, оданПараметр түрі
stringformat: YYYY-MM-DD H:mm:ssАнықтама
Жасалған күн бойынша сүзу,
Мысал сұрау
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 | Көпес ууид |
| items | Төлемдер массиві. Құрылым |
| paginate | Кәмелетке толмағандар туралы мәліметтер. Құрылым |
Құрылымы зат
| Есім | Анықтама |
|---|---|
| uuid | Төлемнің ууидері |
| amount | Төлем сомасы currency |
| currency | Төлемге арналған валюталық код |
| network | Төлем жасалатын блок-жабық желінің коды |
| address | Төлем жасалған әмиянның мекен-жайы |
| txid | Бояудағы транзакция идентификаторы |
| status | Төлем мәртебесі Күту |
| is_final | Төлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады. |
| balance | Саудагердің әмиянындағы қалған қаражат. |
| created_at | Төлемнің құрылған күні. TimeZone - UTC + 3 |
| updated_at | Соңғы төлем жаңартылған күні. TimeZone - UTC + 3 |
Анықтама
Төлемнің ууидеріАнықтама
Төлем сомасы currencyАнықтама
Төлемге арналған валюталық кодАнықтама
Төлем жасалатын блок-жабық желінің кодыАнықтама
Төлем жасалған әмиянның мекен-жайыАнықтама
Бояудағы транзакция идентификаторыАнықтама
Төлем мәртебесі КүтуАнықтама
Төлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады.Анықтама
Саудагердің әмиянындағы қалған қаражат.Анықтама
Төлемнің құрылған күні. TimeZone - UTC + 3Анықтама
Соңғы төлем жаңартылған күні. TimeZone - UTC + 3
Келесі / алдыңғы бет жазбаларын алу үшін, сұрау параметрлеріндегі келесі / алдыңғы жүгіргіні көрсетіңіз (?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 "items": [{
5 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
6 "amount": "3",
7 "currency": "USDT",
8 "network": "TRON",
9 "address": "TJ...",
10 "txid": null,
11 "status": "process",
12 "is_final": false,
13 "balance": "129.00000000",
14 "created_at": "2023-06-21T17:25:55+03:00",
15 "updated_at": "2023-06-21T17:34:38+03:00"
16 }, {
17 "uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
18 "amount": "5.40000000",
19 "currency": "DOGE",
20 "network": "doge",
21 "address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
22 "txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
23 "order_id": null,
24 "payment_status": null,
25 "status": "paid",
26 "is_final": true,
27 "balance": "26.77966652",
28 "created_at": "2023-07-21T17:25:55+03:00",
29 "updated_at": "2023-07-21T17:34:38+03:00"
30 },
31 ...
32 ],
33 "paginate": {
34 "count": 15,
35 "hasPages": true,
36 "nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
37 "previousCursor": null,
38 "perPage": 15
39 }
40}
41}Мүмкін қателер
Тексеру қателері
код : 422
Мысал жауаптары:
Егер Date_from немесе Date_to параметрі дұрыс емес форматта берілсе.
1{
2 "state": 1,
3 "errors": {
4 "date_from": ["validation.regex"]
5 }
6}