API 문서
전체 API
서비스
포인트 사용예약 및 취소동기
버전: v1
버전: v1
/api/v1/payment/point
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
remainTime
number
필수
최소 : 0 , 최대 : 3600000
포인트 사용 예약 시 예약의 유효한 잔여시간
- 단위 : ms
userId
number
필수
최소 : 1 , 최대 : 999999999999999
회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
pointAmount
number
필수
최소 : 1 , 최대 : 1000000000
사용/사용취소 할 포인트 금액
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success
설명
성공
400
에러 코드
000_002
메시지
Invalid input parameter.
설명
입력 파라미터 오류
400
에러 코드
006_023
메시지
Exceed the balance.
설명
잔액 부족
400
에러 코드
006_024
메시지
Exceed the one time limit.
설명
1회 사용한도 초과
400
에러 코드
006_025
메시지
Exceed the day limit.
설명
1일 사용한도 초과
400
에러 코드
006_026
메시지
Exceed the month limit.
설명
1달 사용한도 초과
400
에러 코드
006_029
메시지
Card is not found with the card no.
설명
해당 카드번호로 조회되는 카드 없음
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.