> For the complete documentation index, see [llms.txt](https://apidoc.tokenpay.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.tokenpay.me/ko-kr/undefined-1/undefined-6.md). # 데이터 구조 #### 통화 세부 정보 {% hint style="info" %} 팁（TIP） 통화 세부 정보 {% endhint %} | **이름** | **유형** | **설명** | **예시** | | ------------------------ | ------- | ---------------------- | -------------------------------------------------------------- | | network | string | 네트워크 | 예시 값: `TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` | | chain | string | 소속 퍼블릭 체인 | 예시 값: `TRON`、`ETHEREUM`、`BSC` | | code | string | 통화 코드 | | | currency | string | 통화 | | | name | integer | 이름 | | | logo | integer | 로고 | | | contract\_address | integer | 계약 주소 | | | decimal | integer | | | | Accuracy | | | | | is\_fiat | integer | 법정화폐 여부 | 예 `1` 아니요 `0` | | payment\_qr\_code | integer | 스캔 결제 지원 여부 | 예 `1` 아니요 `0` | | payment\_connect\_wallet | integer | ConnectWallet 결제 지원 여부 | 예 `1` 아니요 `0` | | payment\_tron\_link | integer | tronlink 결제 지원 여부 | 예 `1` 아니요 `0` | | min\_payment\_amount | integer | 최소 결제 금액 | | | max\_payment\_amount | integer | 최대 결제 금액 | | #### 거래 세부 정보 {% hint style="info" %} 팁（TIP） 거래 세부 정보 {% endhint %} | 이름 | 유형 | 설명 | 예시 | | -------------------------- | ------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | out\_trade\_no | string | 가맹점 주문 번호 | | | transaction\_id | string | 플랫폼 주문 번호 | | | description | string | 주문 설명 (utf8-mb4) | | | block\_no | integer | 블록 번호, 이 매개변수를 통해 블록 해시도 조회할 수 있습니다 | | | create\_time | integer | 주문 생성 시간 | | | block\_time | integer | 블록 시간 | | | pay\_time | integer | 결제 시간 (성공 시에만) | | | tx\_id | string | 트랜잭션 해시 | | | from\_address | string | 결제 주소 | | | contract\_address | string | 계약 주소 | | | to\_address | string | 자금 이체 주소 | | | amount | integer | 거래 금액 | | | decimals | integer | 거래 금액 정밀도 | | | pay\_amount | integer | 실제 결제 금액 | | | pay\_decimal | integer | 실제 결제 금액 정밀도 | | | pay\_currency | string | 실제 결제 통화 | | | pay\_chain | string | 실제 결제 퍼블릭 체인: TRON、ETHEREUM、BSC | | | attach | string | 조회 API 및 결제 알림에서 그대로 반환되는 추가 데이터로, 사용자 정의 매개변수로 사용할 수 있습니다. 실제로는 결제 완료 상태만 이 필드에 반환됩니다. | | | service\_amount | integer | 서비스 요금 | | | service\_amount\_currency | string | 서비스 요금 통화 | | | status | integer | 상태 | 1: Unpaid 2: Successful payment 3: Forward refund 4: Closed | | currency | object | 결제 통화 세부 정보 | | | currency.network | string | 네트워크 | 예시 값:`TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` | | currency.chain | string | 소속 퍼블릭 체인 | 예시 값:`TRON`、`ETHEREUM`、`BSC` | | currency.code | string | 통화 코드 | | | currency.currency | string | 통화 | | | currency.name | string | 이름 | | | currency.contract\_address | string | 계약 주소 | | | currency.decimal | integer | | | #### 알림 세부 정보 {% hint style="info" %} 팁（TIP） 트랜잭션 알림 상세 정보 {% endhint %} | **이름** | **유형** | **설명** | **예시** | | ----------------- | -------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | out\_trade\_no | string | 가맹점 주문 번호 | | | transaction\_id | string | 플랫폼 주문 번호 | | | description | string | 주문 설명 (utf8-mb4) | | | block\_no | integer | 블록 번호, 이 매개변수를 통해 블록 해시도 조회할 수 있습니다 | | | create\_time | integer | 주문 생성 시간 | | | block\_time | integer | 블록 시간 | | | pay\_time | integer | 결제 시간 (성공 시에만) | | | tx\_id | string | 트랜잭션 해시 | | | from\_address | string | 결제 주소 | | | contract\_address | string | 계약 주소 | | | to\_address | string | 자금 이체 주소 | | | amount | integer | 거래 금액 | | | decimals | integer | 거래 금액 정밀도 | | | currency | CurrencyDetail | 통화 세부 정보 객체 | | | pay\_amount | integer | 실제 결제 금액 | | | pay\_decimal | integer | 실제 결제 금액 정밀도 | | | pay\_currency | string | 실제 결제 통화 | | | pay\_chain | string | 실제 결제 퍼블릭 체인 TRON、ETHEREUM、BSC | | | attach | string | 조회 API 및 결제 알림에서 그대로 반환되는 추가 데이터로, 사용자 정의 매개변수로 사용할 수 있습니다. 실제로는 결제 완료 상태만 이 필드에 반환됩니다. | | | handle\_status | integer | 처리 상태 | 1: `Pending`; 2: `In progress`; 3:`Processed`; 4:`Wait for verificatio` | | status | integer | 상태 | 1:`Unpaid`; 2:`Successful payment`; 3:`Forward refund`; 4:`Closed`; | | sign | string | 서명 | | | price\_rate | folat | 환율 | | #### 지급 세부 정보 {% hint style="info" %} 팁（TIP） 지급 거래 내역 {% endhint %} | 이름 | 유형 | 설명 | 예시 | | -------------------------- | ------- | ------------ | ------------------------------------------------------------------------------------------ | | out\_trade\_no | string | 가맹점 주문 번호 | 예시 값:`fb72xxxx-xxxx-xxxx-xxxx-xxxx8a7b52cb` | | transaction\_id | string | 플랫폼 주문 번호 | 예시 값:`e98b30294xxxxxxxxxxxx97a9d9e09ce` | | trade\_type | string | 거래 유형 | 예시 값:DAPP、TRANSFER、API | | description | string | 주문 설명 | 예시 값:`recharge` | | block\_no | integer | 블록 번호 | 예시 값:`33215220` | | create\_time | integer | 주문 생성 시간 | 예시 값:`1673407302044` | | block\_time | integer | 블록 시간 | 예시 값:`1673407329000` | | pay\_time | integer | 결제 시간 | 예시 값:`1673407329000` | | tx\_id | string | 트랜잭션 해시 | 예시 값:`9fdf0ab5823e23225f93bcc644af30a6ab83b6583a8e29e359ee80219802a33a` | | from\_address | string | 결제 주소 | 예시 값:`TULRFYoFuEmUbxxxxxxxx8nQYFHJ88888` | | contract\_address | string | 계약 주소 | 예시 값:`TR7NHqjeKQxGTxxxxxxxxpL8otSzgjLj6t` | | to\_address | string | 수금 주소 | 예시 값:`TQjxEW2Z3p9wjoxxxxxxxxgJUrWXBun91w` | | amount | number | 거래 금액 | 예시 값:`15000000` | | pay\_chain | integer | 실제 결제 퍼블릭 체인 | 예시 값:`TRON`、`ETHEREUM`、`BSC`. [View support public chain](/ko-kr/undefined-2/undefined.md) | | decimals | integer | 토큰 정밀도 | 예시 값:`6` | | pay\_network | string | 결제 네트워크 | 예시 값:TRX、TRC10、TRC20、TRC721、TRC1155、ERC20、BEP20 | | pay\_currency | string | 실제 결제 통화 | | | pay\_amount | integer | 실제 결제 | | | pay\_decimal | integer | 실제 결제 금액 정밀도 | | | attach | string | 사용자 정의 매개변수 | 조회 API 및 결제 알림에서 그대로 반환되며, 사용자 정의 매개변수로 사용할 수 있습니다. 실제로는 결제 완료 상태에서만 이 필드가 반환됩니다. | | service\_amount | number | 서비스 요금 | 예시 값:`45000` | | service\_rate | folat | 서비스 요금 비율 | | | service\_amount\_currency | string | 서비스 요금 | 예시 값:`USDT` | | status | integer | 상태 | 예시 값:`1`: Unpaid; `2`: Successful payment; `3`:Forward refund; `4`: Closed; | | handle\_status | integer | 처리 상태 | 예시 값:`1 :` Pending `2` : Processing `3` : Processed `4` : Pending verification | | currency | object | 결제 토큰 세부 정보 | | | currency.network | string | 네트워크 | 예시 값:`TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` | | currency.chain | string | 소속 퍼블릭 체인 | 예시 값:`TRON`、`ETHEREUM`、`BSC` | | currency.code | string | 통화 코드 | | | currency.currency | string | 통화 | | | currency.name | string | 이름 | | | currency.contract\_address | string | 계약 주소 | | | currency.decimal | integer | | | #### 가맹점 잔액 {% hint style="info" %} 팁（TIP） 가맹점 잔액 {% endhint %} | **이름** | **유형** | **설명** | **예시** | | ------------ | ------- | --------- | -------------------------------------------------------------- | | merchant\_id | integer | 가맹점 ID | 예시 값: `1234567890` | | mch\_id | string | 가맹점 ID | 예시 값: `12345678` | | network | string | 네트워크 | 예시 값: `TRX`、`TRC10`、`TRC20`、`TRC721`、`TRC1155`、`ERC20`、`BEP20` | | chain | string | 소속 퍼블릭 체인 | 예시 값: `TRON`、`ETHEREUM`、`BSC` | | balance | string | 잔액 | | | currency | string | 통화 | | | decimal | integer | | | | create\_time | integer | 생성 시간 | 예시 값: `1673333676` | | modify\_time | integer | 수정 시간 | 예시 값: `1673333676` | | cash\_time | integer | 출금 시간 | 예시 값: `1673333676` |