API 문서
전체 API
서비스
기명화 및 한도상향(법인)동기
버전: v1
버전: v1
POST
/api/v1/user/namedcard/corp
법인의 정보를 확인 후, 카드의 법인 기명화와 한도 상향을 처리합니다.
-기명화란?
무기명으로 발행된 카드를 선불전자지급수단을 법에서 정하는 '실지명의 인증' 또는 '예금계좌와 연결하는 방식'을 통하여 해당 선불전자지급수단의 이용자로 특정하는 행위를 말합니다.
-기명화를 하지 않은 경우의 카드 잔액 보유 한도는 50만원이며, 기명화가 완료된 경우 보유 한도를 200만원까지 상향할 수 있습니다. 기명화 완료 후의 보유 한도는 정책적으로 200만원 이내에 설정할 수 있습니다.
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
namedResultList
array of objects
필수
법인기명화 결과 리스트
namedResultList_item
object
옵션
namedResultList_item content
returnMessage
string
옵션
최소 : 1 , 최대 : 100
결과 메세지
par
string
필수
길이 : 27
신청 완료된 par(대체카드번호)
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success
설명
성공
400
에러 코드
003_021
메시지
Cannot find par.
설명
Par 를 찾을 수 없음.
400
에러 코드
003_050
메시지
All named process has been completed.
설명
이미 기명화가 진행된 카드.
테스트 데이터
200 - 성공 데이터
200 - 성공 데이터
400 - Par 를 찾을 수 없음.
400 - 이미 기명화가 진행된 카드.
Loading ...
Request
Loading...
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.
회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제계좌 1원 인증 요청계좌 1원 인증 코드 검증선불카드 발급 및 배송 신청카드 신청 취소선불카드 재발급(교체발급)만료 예정 선불카드 재발급 갱신카드 배송 상태 조회실물카드와 연결 가능한 모바일카드 신청 정보 조회실물카드 등록보유카드 조회미등록 카드 조회카드 상태 변경카드 폐기기명화 및 한도상향(개인)기명화 및 한도상향(법인)법인 기명화 여부 조회소득공제 신청카드 소득공제 신청 여부 조회카드 매핑 회원 조회카드 상품ID로 상품 정보 조회주카드 설정카드에 연결된 가상계좌 조회직불카드 발급 및 배송 신청카드 신청 취소카드 배송 상태 조회실물카드 등록보유카드 조회카드 상태 변경카드 한도 변경카드 폐기소득공제 신청카드 소득공제 신청 여부 조회주카드 설정일회용 토큰 발급계좌 충전계좌 충전취소충전 및 충전취소 결과 확인거래내역 확인기준 하한 및 월정액 자동 충전 활성화기준 하한 자동 충전 등록기준 하한 및 월정액 자동 충전 목록 조회기준 하한 자동 충전 수정월 정액 자동 충전 등록월 정액 자동 충전 수정기준 하한 및 월정액 자동 충전 등록 해제결제 시 자동 충전 등록결제 시 자동 충전 등록 해제결제 시 자동 충전 목록 조회일회용 토큰 발급환불 수수료 조회환불환불 결과 확인시스템 충전(예치금)시스템 충전 취소(예치금)시스템 환불(예치금)시스템 부분환불(예치금)신용카드 충전 거래 생성신용카드 충전 취소 요청편의점 충전/출금 요청예치금 내역 조회예치금 잔액 조회일회용 토큰 발급결제결제취소결제 망취소거래내역 확인포인트 거래내역 확인보유카드 조회포인트 사용예약 및 취소포인트 거래내역 확인관리자 포인트 지급관리자 포인트 환수스탬프카드 적립이력조회보유 스탬프카드 목록 조회보유 마일리지카드 목록 조회마일리지카드 적립이력조회카드로 송금 전송카드로 송금 수신카드로 송금 거절카드로 송금 취소ATM 출금용 일회용 Token 발급ATM 출금 예약ATM 출금 예약 취소ATM 출금 정보 조회선불카드 선물하기선불카드 선물하기 취소선불카드 선물하기 유효성 검증선불카드 선물하기 수락선불카드 선물하기 거절받은 카드/쿠폰 선물 목록 조회보낸 카드/쿠폰 선물 목록 조회카드 선물 수락 V2카드 선물하기 V2카드 잔액 이관잔액 이관 카드 정보 조회현금영수증 발행 요청현금영수증 발행 취소현금영수증 국세청 승인오류 요청현금영수증 식별 정보 등록현금영수증 식별 정보 조회현금영수증 식별 정보 삭제현금영수증 가맹점 등록현금영수증 가맹점 수정가맹점 그룹 생성가맹점 그룹 수정가맹점 그룹 조회가맹점 정보 조회가맹점 그룹 내 가맹점 추가가맹점 그룹 내 가맹점 삭제신용카드 자동충전 설정(기준 하한)신용카드 자동충전 설정(월정액)신용카드 자동충전 활성화신용카드 자동충전 목록 조회신용카드 자동충전 설정 해제신용카드 자동 충전 설정 변경카드 상품 전체 조회 (관리자용)카드 상품 상세 조회 (관리자용)발급 카드 목록 조회 (관리자용)카드 상품 생성 API (관리자용)카드 선물 내역 조회 (관리자용)
