API Documentation
All API
Service
관리자 포인트 지급Sync
Version: v1
Version: v1
/api/v1/point/admin/reward
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
policyId
string
Conditional
Length : 15
포인트 정책 ID
- "pointType"값이 "CARD"값일 경우 필수값
pointType
string
Required
Length : 4
지급한 포인트 타입
- USER : 유저 포인트 사용
- CARD : 카드 포인트 사용
policyName
string
Conditional
Min : 1 , Max : 255
포인트 정책명 입니다.
- "pointType"값이 "CARD"값일 경우 필수값
completedCount
number
Required
Value : 0
지급 완료 건수 입니다
failedCount
number
Required
Value : 0
지급 실패 건수 입니다.
totalPointAmount
number
Required
Value : 0
총 지급된 포인트 입니다.
pointRewardInfoList
array of objects
Required
포인트 지급 정보 리스트 입니다.
pointRewardInfoList_item
object
Optional
userId
number
Required
Min : 1 , Max : 9999999999999999999
회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
- 포인트를 지급받은 회원의 ID입니다.
par
string
Conditional
Length : 27
카드 포인트를 지급받은 카드의 par 입니다.
- "pointType"값이 "CARD"값일 경우 필수값
cardNo
string
Conditional
Length : 16
지급 대상 카드
- "pointType"값이 "CARD"값이면서 "isRewardByToken" 이 ture인 경우 필수값입니다.
amount
number
Required
Min : 0 , Max : 999999999999
지급할 포인트 입니다.
fixedAmount
number
Required
Min : 0 , Max : 999999999999
실제 지급 받은 포인트 입니다.
status
string
Required
Min : 6 , Max : 9
지급 성공 여부 입니다.
- COMPLETED : 지급 완료
- FAILED : 지급 실패
reason
string
Required
Length : 0
지급 결과 사유 입니다
transactionId
string
Optional
Length : 50
외부 연동 거래 코드 값입니다.
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success.
Description
성공
400
Error code
000_002
Message
Invalid input parameter.
Description
입력 파라미터 오류 테스트
400
Error code
000_003
Message
Missing required values.
Description
필수값 누락 테스트
400
Error code
000_008
Message
Internal service error.
Description
내부 서비스 오류.
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!