제휴사의 회원을 KONA PLATE 플랫폼에 회원 가입 처리 합니다. (정회원)

회원 가입

서비스에 가입되어 있는 회원 정보를 조회합니다.

회원 정보 조회

회원의 비밀번호를 재설정 처리합니다.

회원이 비밀번호를 잊어버렸을 경우 또는 새로운 비밀번호를 입력 받아 재설정 해야 할 경우 사용됩니다.

-비밀번호 재설정 요청인 경우
 -기존 비밀번호를 요청 받지 않고, 재설정 할 새로운 비밀번호로 변경 처리 합니다.
-비밀번호 변경 요청인 경우
 -기존 비밀번호를 요청받아 일치 여부를 확인 후, 올바른 비밀번호인 경우 새로운 비밀번호로 변경 처리합니다.

회원 비밀번호 재설정 및 변경

회원 정보를 변경 처리 합니다.

아래 항목에 대해 변경이 가능합니다.

-CI (생년월일, 성별이 바뀌는 경우)
-생년월일
-국가
-이름
-핸드폰 번호
-주소

회원 정보 변경

회원의 서비스 탈퇴를 처리합니다.

아래는 탈퇴가 안되는 경우입니다.

-환불 가능 쿠폰이 있을 경우
-선물한 쿠폰 중, 상대방이 수령하지 않은 쿠폰이 있을 경우
-포인트(+, -) 이 있을 경우
-PLCC 포인트가 있을 경우
-환불 상태 금액이 존재할 경우
-카드(Active card)에 잔액이 있을 경우
-정지 상태 의 카드가 있을 경우
-보낸 선물을 상대방이 수령하지 않은 경우

회원 탈퇴

회원의 로그인 ID를 확인합니다.
회원이 로그인 ID를 잊어버렸을 경우에 사용합니다.
CI값으로 요청하여 회원의 로그인 ID를 반환 받습니다.

회원 로그인 ID 확인

휴면 상태의 회원 정보를 해제 전환 처리합니다.
휴면 회원으로 전환되는 기준은 아래와 같습니다.

- 마지막 접속 후 1년 동안 접속 기록이 없는 경우
- 1년 동안 카드 사용 내역이 없는 경우

휴면 회원 해제

약관 목록을 조회합니다.

- `X-KM-AspId` 정보만 있는 요청인 경우 : 해당 ASP_ID 의 속한 모든 약관 목록을 조회 합니다.
- `userId` 정보 포함된 요청인 경우 : 해당 ASP ID의 속한 모든 약관 목록을 조회하고, 약관 별 해당 회원의 약관 동의 여부가 포함됩니다.

약관 목록 조회

회원 약관의 동의 및 철회 처리합니다.

약관 동의처리 여부가 "true" 인 경우 :
- 요청으로 보내온 약관 목록(List)에 대해 동의로 처리 합니다.

약관 동의처리 여부가 "false" 인 경우 :
- 요청으로 보내온 약관 목록(List)에 대해 철회로 처리 합니다.

약관 동의 및 철회

CI 값으로 서비스에 가입된 회원의 정보를 확인 합니다. 회원이 아닌 경우에는 400으로 응답됩니다.

CI 값으로 회원 정보 조회

로그인 ID, 휴대폰번호로 기 가입된 회원 정보가 있는지 중복 여부를 확인하는 API 입니다.
회원 로그인 ID로 요청하는 경우 : 중복 회원 로그인 ID의 회원을 확인 합니다.
회원 휴대폰 번호로 요청하는 경우 : 중복 휴대 전화번호 회원을 확인 합니다.
회원 로그인 ID & 휴대 전화번호 요청하는 경우 : 중복 회원 로그인 ID 또는 중복 휴대 전화번호 회원을 확인 합니다.
회원 ID & 회원 로그인 ID 요청하는 경우 : 회원 로그인 ID 중복 확인 후, 회원 ID와 일치하는 경우 정상 응답 처리

회원 로그인 ID 중복 확인

회원에게 설정된 비밀번호(6자리)를 검증할 수 있습니다.

회원 비밀번호 검증

회원의 인증 정보 신청 여부를 조회합니다.

회원 인증 정보 조회

회원 관리

연결 가능한 계좌의 은행 및 증권사 목록을 조회하는 API 입니다.

금융사 목록 조회

회원의 이름과 입력 계좌 예금주명의 동일 여부를 확인 합니다.

* 계좌 등록
회원이 카드에 잔액을 충전하기 위해서는 출금 계좌를 등록해야 합니다.
이를 위해서 다음의 2단계를 진행하게 됩니다.
1. 계좌 예금주 실명 검증
2. ARS 인증
계좌가 등록되며 계좌를 통해 선불 카드를 충전할 수 있습니다.

계좌 예금주 실명 검증

계좌 등록을 위한 ARS인증을 위한 인증코드 생성합니다.
계좌 등록 과정 중 두번째 단계인 ARS 인증을 위한 인증코드 생성 합니다.
ARS 인증 과정은 사용자가 ARS를 통해 인증코드를 듣고 앱에 입력하게 됩니다.
이 과정에서 음성 메시지 뿐만 아니라 앱 화면에 인증코드를 보여줌으로써 사용자의 인증 코드 입력의 정확성을 높일 수 있습니다.

ARS 인증 전 인증코드 생성

PG를 통해 회원의 계좌를 등록 처리합니다.
계좌를 등록하거나 이미 등록된 계좌를 신규 계좌로 변경을 처리 합니다.

ARS 인증
회원이 ARS 의 안내에 따라 모바일 화면에 나타난 인증 코드를 정확히 입력하는지 검증한다. ARS 인증의 음성 파일은 녹취되며, 출금이체 동의 자료로 사용된다

계좌 등록
회원이 카드에 잔액을 충전하기 위해서는 출금 계좌를 등록해야 합니다.

이를 위해서 다음의 2단계를 진행하게 됩니다.

1. 계좌 예금주 실명 검증
2. ARS 인증

계좌가 등록되며 계좌를 통해 선불 카드를 충전할 수 있습니다.

PG는 ARS 인증코드를 회원으로부터 입력 받아 인증코드를 검증(ARS 인증) 후, 응답코드를 코어시스템에 전달하고, 계좌 등록 정보를 PG에 요청합니다.
ARS 인증이 유효할 경우 응답("000") 후, 회원의 휴대 전화번호로 ARS 인증 전화 호출 및 출금이체 계좌 등록을 진행합니다.(비동기)

PG를 통한 은행 계좌 등록

계좌 등록 상태를 확인 합니다.

ARS 인증 후, 등록 처리된 계좌의 등록 상태를 조회할 수 있습니다.

계좌 등록 상태 조회

회원의 실지명의 인증 및 예금계좌 연결 정보를 확인 후, 보유한 카드의 기명화와 한도 상향을 처리합니다.
-기명화란?
무기명으로 발행된 카드를 선불전자지급수단을 법에서 정하는 '실지명의 인증' 또는 '예금계좌와 연결하는 방식'을 통하여 해당 선불전자지급수단의 이용자로 특정하는 행위를 말합니다.
-기명화를 하지 않은 경우의 카드 잔액 보유 한도는 50만원이며, 기명화가 완료된 경우 보유 한도를 200만원까지 상향할 수 있습니다. 기명화 완료 후의 보유 한도는 정책적으로 200만원 이내에 설정할 수 있습니다.

기명화 및 한도상향(개인)

회원에게 등록된 계좌를 조회할 수 있는 API 입니다.

회원 등록 계좌 조회

회원의 등록된 계좌 정보를 조회하기 위한 API 입니다.

응답 데이터 중, isAutoRcgAccRegAllowed 는, 자동 충전을 위한 추가 적인 계좌 등록 작업 필요 여부를 나타냅니다. 만일, isAutoRcgAccRegAllowed 가 true일 경우, 은행 계좌를 통한 자동 충전을 설정하기 위해, 2.1.5. 자동 충전 계좌 등록 API를 호출하여, 자동 충전 계좌 등록을 해야 한다. 자동 충전 계좌 등록은, 일반 충전 계좌 등록을 한 상태에서만 가능합니다.

회원 계좌 정보 조회

자동충전을 설정하기 위해 회원의 계좌를 등록할 수 있는 API 입니다. 기존에 인증 및 등록된 계좌를 검증 후 자동충전을 위해 재등록하는 절차입니다.

자동충전 계좌 등록

회원에게 등록된 충전 계좌 정보를 삭제하기 위한 API 입니다.

회원 계좌 삭제

계좌 관리

모바일카드, 실물카드 번호로 결제/충전/환불 등의 거래를 처리하기 위한 일회용 토큰의 발급을 요청하는 API 입니다. 원하는 거래 타입에 따라 토큰의 유효기간을 설정할 수 있습니다.
- 기본값  : 30초
- ATM : ATM 출금 거래 ( 유효기간 : 5분 )
- CREDIT : 신용카드 충전 거래 ( 유효기간 : 5분 )

일회용 토큰 발급

회원에 등록된 계좌를 이용하여 선불카드의 잔액으로 충전을 처리 합니다. 거래데이터를 위한 일회용 Token을 발급받아야 합니다.

계좌 충전

회원 계좌로 부터 충전된 거래를 취소하기 위해 사용합니다.
충전취소된 금액은 카드의 잔액에서 차감 후, 회원의 등록된 계좌로 취소 요청일+1 일에 입급처리 됩니다.

계좌 충전취소

회원에 등록된 계좌를 이용하여 선불카드의 잔액으로 충전 및 충전취소 처리된 결과를 확인 합니다.

충전 및 충전취소 결과 확인

회원이 보유한 카드의 결제내역을 조회합니다.

거래내역 확인

회원이 선택한 선불카드를 발급하고 배송을 원할 경우 신청된 주소로 배송을 처리합니다.

선불카드 발급 및 배송 신청

회원이 신청한 카드를 취소 처리 합니다.
카드를 신청한 당일(요청일) 취소만 가능 합니다.
모바일 카드의 사용 기록이 있을 경우 취소가 불가능 합니다.
카드 신청 취소 시 발급된 모바일 카드는 자동 폐기 됩니다.

카드 신청 취소

회원이 선택한 선불카드를 재발급하고 배송을 원할 경우 신청된 주소로 배송을 처리합니다.
정책에 따라, 재발급 요청 시 재발급 비용이 회원에게 부과가 될 수 있습니다.
카드의 재발급은 아래의 경우에 가능합니다.

- 사용자가 등록을 완료한 카드로 상태가 분실(중지) 상태

선불카드 재발급(교체발급)

만료 예정인 선불카드를 교체 발급하고 신청된 주소로 배송을 처리합니다.
특정 카드 상품의 경우, 재발급 시 회원에게 비용이 부과될 수 있습니다.
카드의 재발급은 아래의 경우에 가능합니다.

- 사용자가 등록을 완료한 카드로 만료가 한 달 이내인 경우

만료 예정 선불카드 재발급 갱신

카드의 배송 상태를 조회합니다.

카드 배송 상태 조회

(회원) 실물카드를 등록하기 전에 카드와 연결할 수 있는 (선발급 카드) 모바일 카드 정보를 조회 할 수 있습니다.
실물카드의 신청 및 재발급 신청 시 선발급된 모바일카드 정보를 확인 할 수 있습니다.
응답 값 "cardApplyNo"는 실물카드 등록 시 입력 값으로 사용됩니다.

선발급 속성의 선불카드 신청이란?
(신규) 회원이 선발급 속성의 선불카드를 신청하는 경우 :
신청 시 모바일카드가 먼저 발급되고 실물카드가 배송됩니다.

(재발급) 재발급되는 카드가 선발급 속성의 선불카드이 경우 :
재발급 신청 시 모바일카드가 먼저 발급되고, 잔액이 새로 발급된 모바일카드로 이관되며 실물카드가 배송됩니다.
모바일 카드는 실물카드 없이 사용 가능한 모바일 전용 카드를 말하여, 사용자는 실물카드 수령 후 모바일카드와 연결할 수 있습니다.

실물카드와 연결 가능한 모바일카드 신청 정보 조회

실물카드를 회원의 App에 등록 처리 합니다.
선불카드를 대상으로 합니다.

실물카드 등록에는 다음의 시나리오가 발생 합니다.

① 선발급 속성의 선불카드 등록 :
모바일카드가 먼저 발급되고 실물카드를 배송 받아 등록하는 경우 입니다.
실물카드를 등록하면 발급된 모바일카드와 연결됩니다.
단, 등록할 실물카드는 거래내역이 없어야 하며, 거래내역이 존재할 경우 ②번의 경우가 됩니다.

② 선발급 속성이 아닌 선불카드 등록 :
선발급 속성의 선불카드가 아닌 경우는 신청 시 모바일카드가 발급되지 않고, 등록 시 모바일카드가 발급되면서 실물카드와 연결되면서 등록이 됩니다.

③ 재발급 신청한 카드에 대한 실물카드 등록 :
선발급 속성의 선불카드를 재발급 신청하였을 경우, 재발급 신청 시 모바일카드가 먼저 발급되고, 잔액이 새로 발급된 모바일카드로 이관되며 실물카드가 배송됩니다.
배송 받은 실물카드를 등록하면 발급된 모바일카드와 연결됩니다.
재발급 신청된 선불카드가 선발급 속성이 아닌 경우에는 실물카드 등록 시 모바일카드가 발급되고, 잔액이 기존 카드에서 새로 발급된 모바일카드로 이관되며 실물카드가 등록됩니다.

④ 체크카드와 연결될 모바일카드에 선불카드 등록 :
체크카드 등록 시 발급된 모바일카드에 실물카드를 연결 합니다.
회원은 연결하고자 원하는 체크카드의 모바일카드를 선택하여 실물카드 등록을 요청할 수 있습니다.

실물카드 등록

회원이 보유한 카드의 목록과 카드 정보를 아래와 같이 제공합니다.

- 카드 상품 정보
- 잔액 정보
- 유효 기간
- 카드 상태
- 카드 번호
- 결제 한도
- 포인트
- 연결 계좌(직불카드인 경우)

보유카드 조회

회원에게 미등록된 카드를 조회합니다. 카드의 카드 번호, 유효기간, CVC를 통해 조회할 수 있습니다.

미등록 카드 조회

카드의 상태를 분실(중지) 또는 분실(중지) 해지 상태로 변경 처리 합니다.

카드 상태 변경

회원이 보유한 등록된 카드를 폐기합니다.

카드를 폐기할 경우 모바일카드와 연결된 모든 실물카드가 폐기되어 더 이상 사용이 불가능합니다.

아래와 같은 경우에는 카드를 폐기할 수 없습니다.
- 카드에 잔액이 있는 경우
- 카드에 포인트가 남아있는 경우
- 송금 진행 중인 카드 (송금 보낸 금액이 있으나 상대방이 수락하지 않은 상태)
- 충전 취소/환불 처리 진행 중인 경우 (취소/환불 신청 후 해당 금액 미입금 상태)

카드 폐기

법인의 정보를 확인 후, 카드의 법인 기명화와 한도 상향을 처리합니다.
-기명화란?
무기명으로 발행된 카드를 선불전자지급수단을 법에서 정하는 '실지명의 인증' 또는 '예금계좌와 연결하는 방식'을 통하여 해당 선불전자지급수단의 이용자로 특정하는 행위를 말합니다.
-기명화를 하지 않은 경우의 카드 잔액 보유 한도는 50만원이며, 기명화가 완료된 경우 보유 한도를 200만원까지 상향할 수 있습니다. 기명화 완료 후의 보유 한도는 정책적으로 200만원 이내에 설정할 수 있습니다.

기명화 및 한도상향(법인)

카드의 법인 기명화 여부를 조회할 수 있는 API 입니다.

법인 기명화 여부 조회

회원이 보유한 카드의 소득공제를 신청처리 합니다.

소득공제 신청

특정 카드의 소득공제 신청 여부를 조회할 수 있는 API 입니다.

카드 소득공제 신청 여부 조회

모바일카드 또는 실물카드의 카드번호의 잔액 정보와 카드번호에 맵핑된 회원 정보를 조회하는 API 입니다.

카드 매핑 회원 조회

카드 상품 ID로 카드 상품명 등의 상품의 정보를 조회할 수 있는 API입니다.