모바일카드, 실물카드 번호로 결제/충전을 처리하기 위한 일회용 Token의 발급을 요청합니다.

발급된 Token의 유효시간은 30초 이며, 30초 안에 결제/충전을 완료해야 합니다.

일회용 Token 발급

일회용 Token을 이용하여 결제를 처리 합니다.

일회용 Token을 획득 후 해당 카드번호로 결제데이터를 만들어 처리합니다.

응답으로 받은 "nrNumber"는 결제 취소 시에 사용 됩니다.

결제

결제 요청 시 응답으로 받은 "nrNumber"와 카드번호로  결제데이터를 만들어 처리합니다.



결제취소

회원이 보유한 포인트의 사용예약 및 예약 취소를 처리 합니다.

결제 시 포인트을 사용하기 위해서는 결제 전 사용할 포인트를 사용 예약하고 10분 이내로 결제를 진행해야 합니다.

포인트 사용예약 및 취소

보유한 카드로 온라인 기반의 결제를 요청하는 API 입니다. 결제 요청하고자 하는 가맹점 계약이 필요합니다.

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

계좌 충전

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

계좌 충전취소

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

충전 및 충전취소 결과 확인

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

거래내역 확인

회원에 등록된 은행 계좌를 통해 보유한 카드의 잔액을 충전을 요청하는 API 입니다.

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

소득공제 신청

카드의 사용내역을 회원의 소득공제 내역으로 신청하는 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만원입니다.

한도상향

가입된 회원에 계좌를 등록하는 API 입니다. 카드 보유 한도의 상향 및 기명화를 위한 필수 조건 입니다.

계좌 관리

일회용 토큰을 이용하여 카드의 잔액을 다른 카드의 잔액으로 송금하는 API 입니다.

카드로 송금 전송

카드의 잔액을 다른 카드로 송금 요청하는 API 입니다. 송금의 승인 및 거절 기능이 가능합니다.

카드로 송금

회원의 카드 잔액을 계좌로 환불 할 때 발생하는 수수료를 조회합니다.

일회용 Token을 획득 후 해당 카드번호로 결제데이터를 만들어 처리합니다.

환불 수수료 조회

회원의 카드 잔액을 계좌로 환불처리 합니다.

일회용 Token을 획득 후 해당 카드번호로 결제데이터를 만들어 처리합니다.

환불

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

환불 결과 확인

회원에 등록된 계좌로 카드의 잔액을 출금 요청하는 카드 잔액 환불 요청 API 입니다.

계좌 환불

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

직불카드 발급 및 배송 신청

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

카드 신청 취소

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

카드 배송 상태 조회

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

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

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

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

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

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

실물카드 등록

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

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

보유카드 조회

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

카드 상태 변경

회원이 소유한 카드의 일/월 결제 한도를 설정 및 변경합니다.

카드 한도 변경

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

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

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

카드 폐기

체크 카드의 신청, 배송, 배송 조회, 회원의 카드 등록, 회원의 보유카드 조회 등 체크카드와 연관된 API 입니다.

체크 카드 관리

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

선불카드 발급 및 배송 신청

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

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

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

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

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

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

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

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

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

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

선불 카드의 신청, 배송, 배송 조회, 회원의 카드 등록, 회원의 보유카드 조회 등 선불카드와 연관된 API 입니다.

선불 카드 관리

제휴사의 회원을 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)에 대해 철회로 처리 합니다.

약관 동의 및 철회

KONA PLATE 플랫폼에 회원 가입 처리 요청 및 회원과 관련된 API 기능 입니다.

회원 관리

회원이 보유한 쿠폰의 사용예약 및 예약 취소를 처리 합니다.

결제 시 쿠폰을 사용하기 위해서는 결제 전 사용할 쿠폰을 사용 예약하고 10분 이내로 결제를 진행해야 합니다.

쿠폰 사용예약 및 취소

회원이 보유 중인 쿠폰 중 특정 쿠폰을 삭제처리 합니다.

쿠폰 삭제

회원이 보유하고 있는 모든 쿠폰의 정보를 조회합니다.

보유 쿠폰 목록 조회

쿠폰 기능과 관련된 API 그룹입니다.

쿠폰 관리

카드 또는 회원의 포인트 거래내역을 조회할 수 있습니다.

포인트 거래의 금액, 정책, 거래 시점, 만료 일자, 가맹점의 정보를 확인할 수 있습니다.

포인트 거래내역 확인

거래 내역과 관련된 API 그룹입니다.