지불금 내역
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'
5 월 4 일부터 5 월 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"
}'응답
응답 매개 변수
의 구조 안건
| 이름 | 정의 |
|---|---|
| uuid | 지불금의 uuid |
| amount | 통화 의 지불 금액 |
| currency | 지불금의 통화 코드 |
| network | 지불금이 이루어진 블록 체인 네트워크의 코드 |
| address | 지불이 이루어진 지갑의 주소 |
| txid | 블록 체인의 트랜잭션 ID |
| status | 지불 상태 상태 |
| is_final | 지불금이 확정되는지 여부지불금 절차는 성공적으로 지불되거나 실패한 경우 지불 절차가 완료된 것으로 간주됩니다. 지불 실패가 발생하면 자금은 잔액으로 반환되어 지불 절차를 다시 시작해야합니다. |
| balance | 상인의 지갑에 나머지 자금. |
| created_at | 지불금의 생성 날짜. 시간대는 UTC+3입니다 |
| updated_at | 마지막 지불 업데이트 날짜. 시간대는 UTC+3입니다 |
정의
지불금의 uuid정의
통화 의 지불 금액정의
지불금의 통화 코드정의
지불금이 이루어진 블록 체인 네트워크의 코드정의
지불이 이루어진 지갑의 주소정의
블록 체인의 트랜잭션 ID정의
지불 상태 상태정의
지불금이 확정되는지 여부지불금 절차는 성공적으로 지불되거나 실패한 경우 지불 절차가 완료된 것으로 간주됩니다. 지불 실패가 발생하면 자금은 잔액으로 반환되어 지불 절차를 다시 시작해야합니다.정의
상인의 지갑에 나머지 자금.정의
지불금의 생성 날짜. 시간대는 UTC+3입니다정의
마지막 지불 업데이트 날짜. 시간대는 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}