업무

post https://api.cryptomus.com/v2/user-api/transaction/list 복사

요구

쿼리 매개 변수

이름매개 변수 유형정의
date_fromstring생성 날짜 기준 필터링(형식: "YYYY-MM-DD H:mm:ss")
date_tostring생성 날짜별로 필터링(형식: "YYYY-MM-DD H:mm:ss")
typestring거래 유형

매개 변수 유형

string

정의

생성 날짜 기준 필터링(형식: "YYYY-MM-DD H:mm:ss")

매개 변수 유형

string

정의

생성 날짜별로 필터링(형식: "YYYY-MM-DD H:mm:ss")

매개 변수 유형

string

정의

거래 유형

요청 예제


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비즈니스 지갑 거래로/로 이체

정의

결제 거래

정의

지급 거래

정의

비즈니스 지갑 거래로/로 이체

응답

응답 매개 변수

이름매개 변수 유형정의
itemsarray 구조
paginateobject 구조

매개 변수 유형

array

정의

구조

매개 변수 유형

object

정의

구조

항목 응답 매개변수

이름매개 변수 유형정의
uuidstring거래 UUID
typestring거래 유형
statusstring|null 구조
created_atstring거래시간
amountstring양
amount_equivalentstring|null등가액
currency_equivalentstring|null통화 상당 금액(개인 계정에 설정된 통화)
currencystring통화 코드
networkstring|null블록 체인 네트워크 코드
txidstring|null거래 해시
addressstring|null지불을위한 지갑 주소
commentstring|null해설

매개 변수 유형

string

정의

거래 UUID

매개 변수 유형

string

정의

거래 유형

매개 변수 유형

string|null

정의

구조

매개 변수 유형

string

정의

거래시간

매개 변수 유형

string

정의

양

매개 변수 유형

string|null

정의

등가액

매개 변수 유형

string|null

정의

통화 상당 금액(개인 계정에 설정된 통화)

매개 변수 유형

string

정의

통화 코드

매개 변수 유형

string|null

정의

블록 체인 네트워크 코드

매개 변수 유형

string|null

정의

거래 해시

매개 변수 유형

string|null

정의

지불을위한 지갑 주소

매개 변수 유형

string|null

정의

해설

페이지 매김 응답 매개변수

이름매개 변수 유형정의
countinteger현재 페이지의 항목 수
hasPagesboolean여러 페이지로 나누기에 충분한 요소가 있는지 여부 (true / false)
nextCursorstring|null다음 페이지로 커서
previousCursorstring|null이전 페이지로 커서
perPageinteger페이지 당 최대 요소 수

매개 변수 유형

integer

정의

현재 페이지의 항목 수

매개 변수 유형

boolean

정의

여러 페이지로 나누기에 충분한 요소가 있는지 여부 (true / false)

매개 변수 유형

string|null

정의

다음 페이지로 커서

매개 변수 유형

string|null

정의

이전 페이지로 커서

매개 변수 유형

integer

정의

페이지 당 최대 요소 수

상태 응답 매개변수

이름정의
check블록체인에 트랜잭션이 나타날 때까지 기다리는 중
paid거래가 성공했습니다
fail거래 오류
cancel거래가 취소되었습니다.
lockedAML 프로그램으로 인해 자금이 잠겨 있습니다

정의

블록체인에 트랜잭션이 나타날 때까지 기다리는 중

정의

거래가 성공했습니다

정의

거래 오류

정의

거래가 취소되었습니다.

정의

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
복사