Wallet API
본 문서는 주식회사 매스어답션에서 제공하는 블록체인(NFT) 기반의 디지털 보증 솔루션 연동에 관한 기술문서입니다. API 서비스는 허가된 사용자만 이용이 가능합니다. 사용 요청은 버클 홈페이지(https://partners.vircle.co.kr)의 도입문의 또는 [email protected] 로 문의주시기 바랍니다.
* 적용일자: 2022년 10월 1일 * 작성자: 김현태 ([email protected])
버클 지갑 서비스 소개
버클 지갑은 사용자의 디지털 보증서를 쉽고 편리하게 관리해 주는 개인 디지털 지갑 서비스입니다. 기존에 불편했던 가상자산 지갑 서비스와 달리 카카오톡과 연동되어 쉽고 편리한 사용자 경험을 제공합니다.
사용자는 블록체인에 대한 지식 없이도 개인화된 링크를 통해 단 몇 번의 클릭만으로 지갑 생성과 연동이 완료됩니다.
소비자는 보증서를 발급받은 판매몰 또는 버클 앱을 통해 보유한 디지털 보증서를 확인할 수 있으며, 감정/수선 서비스 및 소유권 이전 등의 부가서비스를 이용할 수 있습니다.
지갑 연동 프로세스
1. 상품 배송완료 후(권고 7일 후) 발급안내 알림톡(또는 SMS)를 발송합니다. - 알림톡(또는 SMS) 발송 주체는 사전 협의가 필요하며, 버클 알림 서비스를 이용할 경우 해당 로직을 구현할 필요가 없습니다. - 판매몰에서 자체 발송할 경우 발송 시점을 특정하기 위한 배치 프로그램을 직접 구축해야합니다.
2. 사용자는 해당 링크를 통해 버클 브릿지 페이지에 접속합니다. - 해당 브릿지 페이지 디자인은 커스텀 가능하며 협의가 필요합니다.
3. [보증서 발급하기] 버튼 클릭 시 카카오톡 인증 절차를 통해 사용자 정보제공 동의를 진행합니다.
4. 인증을 완료하면 지갑을 자동으로 생성하고 디지털 보증서가 발행되며 연동절차가 완료됩니다.
5. 연동 완료 후 자동으로 디지털 보증서 상세페이지로 이동되며, 복귀하길 희망하는 URL(또는 Deep Link)를 파라미터(redirectUrl)로 전달하면 해당 페이지로 Redirect 처리됩니다.
인증 (Authentication)
공통 에러
Unauthorized는 호출하는 API 종류에 상관없이 인증 시스템이 정상적으로 실행되지 않으면 발생합니다.버클 API는 표준 REST API와 같은 토큰 기반 인증을 사용합니다. 모든 요청은 반드시 올바른 Authorization 헤더를 가져야 합니다.
할당 받은 API 키(VIRCLE_API_KEY)를
X-Vircle-API-Key로, 클라이언트 암호(VIRCLE_API_SECRET)를Authorization로 사용하여 자격증명을 생성합니다.계정 보안을 위해 해당 키와 암호는 타인과 함부로 공유하지 말고 외부에 노출되지 않도록 보관합니다.
401: Unauthorized
Code
Message
UNAUTHORIZED_ERROR
API 인증정보를 확인할 수 없습니다.
UNAUTHORIZED_ERROR
파트너 정보를 조회할 수 없습니다.
API 목록
(Redirect) 사용자 지갑 사전연동지갑 주소 유효성 검사사용자 지갑 주소 조회(Webhook) 지갑주소 업데이트Last updated