{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"7852dd08-b7e6-466b-8b0c-27f677b56eab","name":"VIRCLE API SERVICE","description":"\n\n\\-\n\n> 본 문서는 주식회사 매스어답션에서 제공하는 버클 솔루션 연동에 관한 기술문서입니다. API 서비스는 허가된 사용자만 이용이 가능합니다. 사용 요청은 버클 홈페이지([https://vircle.co.kr](https://vircle.co.kr)) 도입문의 또는 [sales@vircle.co.kr](https://mailto:sales@vircle.co.kr) 로 문의주시기 바랍니다. \n \n\n\\-\n\n# 버클(vircle) 소개\n\n- 버클(vircle)은 블록체인(NFT) 기술을 통해 디지털 개런티를 안전하고 손쉽게 발급할 수 있는 통합 솔루션 입니다.\n \n- 소비자는 카카오톡을 통해 클릭 몇 번만으로 발급받을 수 있으며, 디지털 개런티를 통해 명품 감정, 수선 및 중고거래 등의 부가 서비스를 제공받을 수 있습니다.\n \n- vircle API service 는 Enterprise 고객분들에게 제공되는 서비스로, 판매몰의 주문정보와 직접 연동하여 관리자의 개입 없이도 자동으로 발급할 수 있는 기능들을 제공합니다.\n \n\n\n\n\\-\n\n\n\n\\-\n\n# 시작하기\n\nvircle API service 는 현재 허가된 사용자만 접근이 가능합니다. 서비스 이용을 희망하시는 파트너사는 별도의 계약을 통해 서비스를 이용하실 수 있습니다.\n\n1. 버클 홈페이지([https://partners.vircle.co.kr](https://partners.vircle.co.kr))의 도입문의 또는 [partners@vircle.co.kr](https://mailto:partners@vircle.co.kr) 로 간단한 회사소개와 담당자 연락처를 보내주시기 바랍니다.\n \n2. 내부에서 검토 후 담당자분께 연락드려 별도의 계약을 진행합니다.\n \n3. 담당자 배정 후 API 사용에 필요한 계정 셋팅 후 인증정보 등을 전달드립니다.\n \n\n---\n\n# 1\\. 주문 연동 서비스\n\n- 주문 API는 고객의 구매 내역을 등록하고 관리하기 위한 API입니다.\n \n- 외부 쇼핑몰이나 자체 시스템의 주문 데이터를 연동하여, 주문자 정보·판매처·주문 상품을 하나의 주문 단위로 관리할 수 있습니다. 등록된 주문 데이터는 보증서 발급 및 고객 구매 이력 추적에 활용됩니다.\n \n- 디지털 개런티 서비스를 이용중이라면 주문데이터 기반으로 구매 고객에게 개런티가 자동으로 발급됩니다.\n \n\n\n\n---\n\n# 2\\. 디지털 보증서 서비스\n\n- 디지털 보증서 API는 고객이 구매한 제품의 보증서를 발급하고 관리하기 위한 API입니다.\n \n- 판매한 제품에 대해 디지털 보증서를 발급하여 제품의 정품 인증, 보증 이력, 소유권 이전 등을 관리할 수 있습니다. 발급된 보증서는 고객에게 전달되어 제품의 진위 확인 및 AS 이력 추적에 활용됩니다.\n \n- 디지털 보증서 발급신청을 하면 버클에서 소비자에게 알림톡으로 개런티 발급 링크를 전달하며, 소비자는 최초 1회 간편 로그인 절차를 거쳐 보증서를 발급받게 되며, 이후에는 별도의 절차 없이 자동 발급됩니다.\n \n\n\n\n---\n\n# 3\\. 고객 연동 서비스\n\n- 고객 API는 외부 시스템의 고객 정보를 등록하고 관리하기 위한 API입니다.\n \n- 자사 ERP 및 CRM, 쇼핑몰 등 외부 시스템에서 관리하는 고객 데이터를 연동하여 고객 프로필을 통합 관리할 수 있습니다. 등록된 고객은 개런티 발급, 주문 연동, 포인트 관리의 기준 정보로 활용됩니다.\n \n\n\n\n---\n\n# 4\\. 판매처 연동 서비스\n\n- 판매처 API는 파트너사의 판매 채널을 등록하고 관리하기 위한 API입니다.\n \n- 오프라인 매장, 자사몰, 플랫폼(네이버, 카페24) 등 다양한 판매 채널을 판매처로 등록하여 제품의 판매 경로를 체계적으로 관리할 수 있습니다.\n \n- 등록된 판매처는 주문연동 및 보증서 발급 시 판매처별 분석에 활용됩니다.\n \n\n\n\n---\n\n# 5\\. 상품 연동 서비스\n\n- 상품 API는 파트너사의 상품 정보를 등록하고 관리하기 위한 API입니다.\n \n- 외부 쇼핑몰이나 자체 시스템의 상품 데이터를 연동하여, 보증서 발급 시 상품 정보를 자동으로 매핑할 수 있습니다. 등록된 상품은 보증서의 제품 정보로 활용되며, 상품 코드를 기준으로 일관된 상품 관리가 가능합니다.\n \n\n\n\n---\n\n# 래퍼런스\n\n\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"18065231","team":1591261,"collectionId":"7852dd08-b7e6-466b-8b0c-27f677b56eab","publishedId":"2s83zcRmZw","public":true,"publicUrl":"https://api-docs.vircle.co.kr","privateUrl":"https://go.postman.co/documentation/18065231-7852dd08-b7e6-466b-8b0c-27f677b56eab","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"526EFF"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"526EFF"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"526EFF"}}]}},"version":"8.10.1","publishDate":"2025-05-14T11:56:05.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"live","id":"a06d45b2-7028-4568-ad3a-8a3032bf1f18","owner":"18065231","values":[{"key":"base-url","value":"api.vircle.co.kr","enabled":true},{"key":"port","value":"443","enabled":true},{"key":"protocol","value":"https","enabled":true,"type":"default"},{"key":"klaytn-api-id","value":"KASKHNCX4P18C7E53YCO8KIT","enabled":true,"type":"default"},{"key":"klaytn-api-secret","value":"fVtbNH9km1iyWCfORdo5wOSJH4THuDccjHE9r5br","enabled":true,"type":"secret"},{"key":"klaytn-account-pool-krn","value":"krn:8217:wallet:b9af5729-da7e-4f14-a8ac-b2328974c99d:account-pool:vircle","enabled":true,"type":"default"},{"key":"klaytn-account-pool-address","value":"0xC019565b3347A1184bCe1486e0a3D8A3a7Aba70a","enabled":true,"type":"default"},{"key":"klaytn-chain-id","value":"8217","enabled":true,"type":"default"},{"key":"klaytn-project-vircle-id","value":"KASPX7D0UFJNEWWI91JNLNZH","enabled":true,"type":"default"},{"key":"klaytn-project-vircle-pw","value":"ni_2E_Sj5Cpulgww50mA7wz8rWfucehRTxwh6mEk","enabled":true,"type":"secret"},{"key":"klaytn-fee-player-krn","value":"krn:8217:wallet:b9af5729-da7e-4f14-a8ac-b2328974c99d:feepayer-pool:vircle-fee","enabled":true,"type":"default"},{"key":"klaytn-fee-player-address","value":"0xA2744DBc9B9db5b95b418FaA66b644a2e879F9cb","enabled":true,"type":"default"},{"key":"base-app-url","value":"app.vircle.co.kr","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/50dd8199bad2b9df220ba0d7baa0de26fe5661a9bb41bcf71d34e782fe9dfb73","favicon":"https://vircle.co.kr/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"live","value":"18065231-a06d45b2-7028-4568-ad3a-8a3032bf1f18"}],"canonicalUrl":"https://api-docs.vircle.co.kr/view/metadata/2s83zcRmZw"}