getCoinHistoryList
- Print
- PDF
getCoinHistoryList
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
Overview
Gets status of coins given to each account, along with their usage history.
Requests
Request parameters
| Parameters | Requirement status | Type | Restrictions | Description |
|---|---|---|---|---|
| pageNo | No | Integer | Page number | |
| pageSize | No | Integer | - Page size default: 1000 max: 1000 | |
| discountNoList.N | No | List<String> | Enter the coin number to view. The usage history of all coins is displayed if no input is provided. The coin number can be found in the getDiscountList API. | |
| isOrganization | No | Boolean | - Whether to conduct integrated search for Organization accounts (available to Organization masters) An error is returned if both isOrganization and isPartner are true | |
| isPartner | No | Boolean | - Whether to search partner accounts (available to representative accounts of partners) An error is returned if both isOrganization and isPartner are true | |
| memberNoList.N | No | List<String> | List of member numbers (available to Organization masters or representative accounts of partners) | |
| responseFormatType | No | String | - Format type of the response result Options: xml | json Default: xml |
Responses
Response bodies
Examples
Request examples
GET {API_URL}/discount/getCoinHistoryList
?discountNoList.1=54&discountNoList.2=55
Response examples
<?xml version="1.0" encoding="UTF-8"?>
<getCoinHistoryList>
<requestId>103****-****-****-****-****6563ca0b</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>2</totalRows>
<coinHistoryList>
<coinHistory>
<memberNo>******</memberNo>
<coin>
<discountNo>54</discountNo>
<coinChagedNo>42</coinChagedNo>
<coinName>Bank transfer(Nonghyup)</coinName>
<coinType>
<code>COIN</code>
<codeName>Common Coin</codeName>
</coinType>
<chargedCoin>100000</chargedCoin>
<remainingCoin>100000</remainingCoin>
<coinStatus>
<code>NOML</code>
<codeName>Normal</codeName>
</coinStatus>
<validityStartMonth>202007</validityStartMonth>
<validityEndMonth>202307</validityEndMonth>
</coin>
<coinUseHistory/>
</coinHistory>
<coinHistory>
<memberNo>******</memberNo>
<coin>
<discountNo>55</discountNo>
<coinChagedNo>42</coinChagedNo>
<coinName>Bank transfer(Nonghyup)</coinName>
<coinType>
<code>BONUS</code>
<codeName>Bonus Coin</codeName>
</coinType>
<chargedCoin>1500</chargedCoin>
<remainingCoin>1500</remainingCoin>
<coinStatus>
<code>RFNDSS</code>
<codeName>Refund Success</codeName>
</coinStatus>
<validityStartMonth>202007</validityStartMonth>
<validityEndMonth>202107</validityEndMonth>
</coin>
<coinUseHistory/>
</coinHistory>
</coinHistoryList>
</getCoinHistoryList>
Was this article helpful?