API Documentation
All API
Service
Stamp card accumulation history inquirySync
Version: v1
Version: v1
/api/v1/stamp/cards/history
Request Headers
Request Parameters
Response Headers
X-KM-Correlation-Id
string
Required
Length : 20
Transaction number for tracking trasncription
- Form : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7digit, Hex String
X-KM-Crypto-Key-Id
string
Optional
Length : 32
Data encryption/decryption key ID
- Given ID from creating the service provider's project
- If it is passed as a callback, the first key issued among the keys issued to the service provider is used.
Response Parameters
userStampHistoryResList
array of objects
Optional
Stamp Card Simple Information
userStampHistoryResList_item
object
Optional
approvalDateTime
string
Optional
Length : 17
Approval time
Format : yyyyMMddHHmmssSSS
count
number
Optional
Min : 0 , Max : 9999999999999999999
Number of accumulation requests
createdDateTime
string
Optional
Length : 17
Date Created
Format : yyyyMMddHHmmssSSS
merchantId
string
Optional
Length : 15
The ID of merchant where stamps have been accumulated or canceled
merchantType
string
Optional
Length : 2
Type of merchant where stamps have been accumulated or canceled
- MC: Kona Merchant
nrNumber
string
Optional
Length : 18
Kona transaction unique number
rewardStatus
string
Optional
Min : 6 , Max : 8
Processing status of compensation (coupon) upon completion of stamp card
- null, if no compensation history
- If (type=10), that may have the following status values.
- REWARD: Compensation completed
- Other than (type=10), that may have the following status values.
- WITHDRAW: Compensation Recovery Successful
- DISCARD: Compensation recovery failed
type
string
Optional
Length : 2
Stamp accumulation type
10: Accumulation
40: Cancellation of accumulation
42: Network cancellation of accumulation history
updatedDateTime
string
Optional
Length : 17
revision date
Format : yyyyMMddHHmmssSSS
pageResponse
object
Required
About paging responses
page
number
Required
Min : 0 , Max : 1000
Current Page
totalPages
number
Required
Min : 0 , Max : 1000
Total number of pages
numberOfElements
number
Required
Min : 0 , Max : 10000
Total list count
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success.
Description
success
500
Error code
000_001
Message
Unknown Reason.
Description
Unknown error
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!
