어드민 회원 주카드로 포인트 지급

API Description

Doc. No. A12S1D3V1
API Title 포인트 > 어드민 회원 주카드로 포인트 지급
API Description 어드민(관리자)에 의한 회원의 주카드로의 포인트 적립을 요청하는 API 입니다.
Protocol HTTP Interface Type SYNC
HTTP METHOD POST Request URL /api/v1/point/admin/reward/favorite-card
Data Encryption Request : YES / Response : YES

Request Parameter

Field Type Length MOC Description
affiliateId STRING 15 MANDATORY 카드 포인트 지급에 필요한 제휴사 ID
validMonthLength NUMBER 1~99 CONDITIONAL 포인트가 유효한 개월 수
- expiryDate이 null인 경우 필수값입니다.
expiryDate STRING 8 CONDITIONAL 포인트 지정 만료일
- 형식 : yyyyMMdd
- validMonthLength이 null인 경우 필수 값입니다.
policyId STRING 15 MANDATORY 포인트 정책 ID
policyLimitMonthIgnored BOOLEAN OPTIONAL 유저당 캐시정책 월 지급 제한 무시 여부
- 기본값 : false
policyLimitYearIgnored BOOLEAN OPTIONAL 회원 당 캐시정책 년 지급 제한 무시 여부
- 기본값 : false
pointRewardInfoList ARRAY MANDATORY 포인트 발급 정보 목록
userId NUMBER 1~999999999999 MANDATORY 회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
amount NUMBER 0~999999999999 MANDATORY 지급할 포인트
transactionId STRING 50 OPTIONAL 외부 연동 거래 코드
adminPointMessageInfo OBJECT MANDATORY 지급 사유 정보
reason STRING 1~255 MANDATORY 지급 사유

Response Parameter

Field Type Length MOC Description
policyId STRING 15 MANDATORY 포인트 정책 ID
policyName STRING 1~255 MANDATORY 포인트 정책명
totalPointAmount NUMBER 0~999999999999 MANDATORY 총 지급된 포인트
pointRewardInfoList OBJECT MANDATORY 포인트 지급 정보 목록
userId NUMBER 0~999999999999 MANDATORY 회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
- 포인트를 지급 받은 회원의 ID입니다.
par STRING 27 CONDITIONAL 카드 포인트를 지급 받은 카드의 par
amount NUMBER 0~999999999999 MANDATORY 지급할 포인트
fixedAmount NUMBER 0~999999999999 MANDATORY 실제 지급 받은 포인트
status STRING 6~9 MANDATORY 지급 성공 여부
- COMPLETED : 지급 완료
- FAILED : 지급 실패
reason STRING 1~255 MANDATORY 지급 결과 사유
transactionId STRING 650 OPTIONAL 외부 연동 거래 코드
response OBJECT MANDATORY 응답 결과 값
code STRING 1~7 MANDATORY 응답 결과 코드
description STRING 1~255 MANDATORY 응답 결과 상세 설명

Response Code

HTTP Status Error code Message Description
프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다.

Example

Request


            

Response