지불금 내역

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'

복사

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"
}'

복사

응답

응답 매개 변수

이름	매개 변수 유형	정의
merchant_uuid	string	가맹점의 uuid
items		지불금 배열. 구조
paginate		페이지 매김을위한 데이터. 구조

: 매개 변수 유형
string
정의
가맹점의 uuid
: 정의
지불금 배열. 구조
: 정의
페이지 매김을위한 데이터. 구조

의 구조 안건

이름	매개 변수 유형	정의
uuid	string	지불금의 uuid
amount	string	통화 의 지불 금액
currency	string	지불금의 통화 코드
network	string\|null	지불금이 이루어진 블록 체인 네트워크의 코드
payer_currency	string\|null	지불금이 실제로 이루어질 cryptocurrency 코드. 지불금 주소는 지불 통화를받습니다.
payer_amount	string\|null	지불금의 payer_currency 금액.
address	string	지불이 이루어진 지갑의 주소
txid	string\|null	블록 체인의 트랜잭션 ID
status	string	지불 상태 상태
payment_status	string	지불 상태
is_final	boolean	지불금이 확정되는지 여부지불금 절차는 성공적으로 지불되거나 실패한 경우 지불 절차가 완료된 것으로 간주됩니다. 지불 실패가 발생하면 자금은 잔액으로 반환되어 지불 절차를 다시 시작해야합니다.
balance	string\|null	상인의 지갑에 나머지 자금.
order_id	string\|null	시스템에서 ID를 주문하십시오
commission	string\|null	Cryptomus위원회 금액
merchant_amount	string\|null	모든 수수료를 포함하여 상인의 잔액에서 차감 된 금액.
created_at	string\|null	지불금의 생성 날짜. 시간대는 UTC+3입니다
updated_at	string\|null	마지막 지불 업데이트 날짜. 시간대는 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
정의
지불금의 uuid
: 매개 변수 유형
string
정의
통화 의 지불 금액
: 매개 변수 유형
string
정의
지불금의 통화 코드
: 매개 변수 유형
string|null
정의
지불금이 이루어진 블록 체인 네트워크의 코드
: 매개 변수 유형
string|null
정의
지불금이 실제로 이루어질 cryptocurrency 코드. 지불금 주소는 지불 통화를받습니다.
: 매개 변수 유형
string|null
정의
지불금의 payer_currency 금액.
: 매개 변수 유형
string
정의
지불이 이루어진 지갑의 주소
: 매개 변수 유형
string|null
정의
블록 체인의 트랜잭션 ID
: 매개 변수 유형
string
정의
지불 상태 상태
: 매개 변수 유형
string
정의
지불 상태
: 매개 변수 유형
boolean
정의
지불금이 확정되는지 여부지불금 절차는 성공적으로 지불되거나 실패한 경우 지불 절차가 완료된 것으로 간주됩니다. 지불 실패가 발생하면 자금은 잔액으로 반환되어 지불 절차를 다시 시작해야합니다.
: 매개 변수 유형
string|null
정의
상인의 지갑에 나머지 자금.
: 매개 변수 유형
string|null
정의
시스템에서 ID를 주문하십시오
: 매개 변수 유형
string|null
정의
Cryptomus위원회 금액
: 매개 변수 유형
string|null
정의
모든 수수료를 포함하여 상인의 잔액에서 차감 된 금액.
: 매개 변수 유형
string|null
정의
지불금의 생성 날짜. 시간대는 UTC+3입니다
: 매개 변수 유형
string|null
정의
마지막 지불 업데이트 날짜. 시간대는 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}

복사