업무
get
https://api.cryptomus.com/v2/user-api/transaction/list
요구
쿼리 매개 변수
이름 | 정의 |
---|---|
date_from | 생성 날짜 기준 필터링(형식: "YYYY-MM-DD H:mm:ss") |
date_to | 생성 날짜별로 필터링(형식: "YYYY-MM-DD H:mm:ss") |
type | 거래 유형 |
정의
생성 날짜 기준 필터링(형식: "YYYY-MM-DD H:mm:ss")정의
생성 날짜별로 필터링(형식: "YYYY-MM-DD H:mm:ss")정의
거래 유형
요청 예제
curl https://api.cryptomus.com/v2/user-api/transaction/list \
-X POST \
-H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"date_from": "2023-05-16 00:00:00"
"date_to": "2023-05-16 23:59:59"
"type": "payment"
}'
복사유형
요청 유형
이름 | 정의 |
---|---|
payment | 결제 거래 |
payout | 지급 거래 |
transfer | 비즈니스 지갑 거래로/로 이체 |
정의
결제 거래정의
지급 거래정의
비즈니스 지갑 거래로/로 이체
응답
응답 매개 변수
항목 응답 매개변수
이름 | 정의 |
---|---|
uuid | 거래 UUID |
type | 거래 유형 |
status | 구조 |
amount | 양 |
amount_equivalent | 등가액 |
currency_equivalent | 통화 상당 금액(개인 계정에 설정된 통화) |
currency | 통화 코드 |
comment | 해설 |
network | 블록 체인 네트워크 코드 |
address | 지불을위한 지갑 주소 |
txid | 거래 해시 |
created_at | 거래시간 |
정의
거래 UUID정의
거래 유형정의
구조정의
양정의
등가액정의
통화 상당 금액(개인 계정에 설정된 통화)정의
통화 코드정의
해설정의
블록 체인 네트워크 코드정의
지불을위한 지갑 주소정의
거래 해시정의
거래시간
페이지 매김 응답 매개변수
이름 | 정의 |
---|---|
count | 현재 페이지의 항목 수 |
hasPages | 여러 페이지로 나누기에 충분한 요소가 있는지 여부 (true / false) |
nextCursor | 다음 페이지로 커서 |
previousCursor | 이전 페이지로 커서 |
perPage | 페이지 당 최대 요소 수 |
정의
현재 페이지의 항목 수정의
여러 페이지로 나누기에 충분한 요소가 있는지 여부 (true / false)정의
다음 페이지로 커서정의
이전 페이지로 커서정의
페이지 당 최대 요소 수
상태 응답 매개변수
이름 | 정의 |
---|---|
check | 블록체인에 트랜잭션이 나타날 때까지 기다리는 중 |
paid | 거래가 성공했습니다 |
fail | 거래 오류 |
cancel | 거래가 취소되었습니다. |
locked | AML 프로그램으로 인해 자금이 잠겨 있습니다 |
정의
블록체인에 트랜잭션이 나타날 때까지 기다리는 중정의
거래가 성공했습니다정의
거래 오류정의
거래가 취소되었습니다.정의
AML 프로그램으로 인해 자금이 잠겨 있습니다
다음/이전 페이지의 레코드를 가져오려면 쿼리 매개변수에 다음/이전 커서 해시를 지정하세요. (?cursor=<nextCursorHash>)
예:
curl https://api.cryptomus.com/v2/user-api/transaction/list?cursor=eyJpZCI6MjEyLCJ fcG9pbnRzVzVG9OZhXh0SXRlbXMiOnRydWV9 \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{}'
복사응답 예
1{
2 "state": 0,
3 "result": {
4 "items": [
5 {
6 "uuid": "3a3efbe5-4835-48f3-95c0-7b63e2c8a0b6",
7 "type": "transfer",
8 "status": "paid",
9 "created_at": "2022-07-22T15:11:46.000000Z",
10 "amount": "10.00",
11 "amount_equivalent": "10.1679",
12 "currency_equivalent": "USD",
13 "currency": "USDT",
14 "network": null,
15 "txid": null,
16 "address": null,
17 "comment": null
18 },
19 {
20 "uuid": "d4953ea1-6f55-46f1-b1c9-f72c04badc45",
21 "type": "payout",
22 "status": "paid",
23 "created_at": "2022-09-01T14:46:44.000000Z",
24 "amount": "10.00",
25 "amount_equivalent": "10.1679",
26 "currency_equivalent": "USD",
27 "currency": "USDT",
28 "network": "tron",
29 "txid": null,
30 "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
31 "comment": null
32 },
33 {
34 "uuid": "690f745a-6b0c-42e1-a6ee-0de34485cab7",
35 "type": "payment",
36 "status": "fail",
37 "created_at": "2022-09-02T08:32:03.000000Z",
38 "amount": "2.00",
39 "amount_equivalent": "10.63359",
40 "currency_equivalent": "USD",
41 "currency": "USDT",
42 "network": "tron",
43 "txid": null,
44 "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
45 "comment": null
46 }
47 ],
48 "paginate": {
49 "count": 3,
50 "hasPages": true,
51 "nextCursor": "eyJpdiI6IlFIZnd5Lzd0VUN3TGtUNUF6ckV5TEE9PSIsInZhbHVlIjoiUHcvZm1rWmRqdDVKL25NMW5EVEQ1OW9JS0NiSjhJcHd1byt5SGhmVG95UjhGaUlCa3djT1ZSOU5Lc29Id3B3bC80T0VBSnhhZEZBWk1yZUN5RTByN2pKK0dNVUZ0QnFlcThwMU93d0NSR2pXMHJOQWZIa3N6cStmT0YxOG9VVDJyT1Q2NmVhbU9JU1N6cTJsM3JLTitRPT0iLCJtYWMiOiI2M2E4OWVmZTk3MDNjYzUwNjY0ZWY4ZjcxMjUyOGUzMmI4NzNkNWU4YzNlYmUxNmNmMThhM2JhN2RjNTkyYjgxIiwidGFnIjoiIn0=",
52 "previousCursor": null,
53 "perPage": 15
54 }
55 }
56}
57
복사