파트너사 가입 및 인증
파트너사 회원가입
POST /v1/partners/signup
파트너사의 회원 가입을 처리합니다.
필수 정보를 입력받아 파트너사 계정을 생성합니다.
파트너키는 사전 협의에 따라 UUID(트레져러 발급) 또는 커스텀 형식(제휴사 발급)으로 상호 저장/관리합니다.
생성 완료 시 파트너사 식별 정보를 반환합니다.
Headers
Content-Type
application/json
Body (Example)
{
"traceNo": "2b454b5b-3004-4b8e-8acc-e05f7a8d2cd3", // [Required] 추적을 위해 클라이언트에서 제공하는 임의의 문자열(UUID, timestamp 등)
"partner": "lpoint", // [Required] 미리 지정된 파트너 스트링 'syrup' | 'kb' | 'lpoint' | 'myb' | 'smartscore'
"partnerKey": "홍길동_01012345678" // [Optional] 트레져러 측에서 발급할 경우 제공 불필요하며, 사전 협의된 파트너키 포맷이 있을 경우 협의사항에 맞춰 제공
"userInfo": {
"name": "홍길동", // [Required] CI인증에서 사용된 이름
"birthday": "19900101", // [Required] 인증에 사용된 생년월일 YYYYMMDD
"nationality": "K", // [Required] 내국인 사용가능
"mdn": "01000000000", // [Required] 인증에 사용된 휴대폰 번호
"gender": "M", // [Required] 인증에 사용된 성별, "F" | "M"
"ci": "ci1234567890" // [Required] 통신사 인증 CID(88자 길이의 문자열)
},
"termsList": [
{
"termsId": "marketing", // 마케팅 동의
"agreeYn": "Y"
}
]
}Response (Example)
{
"traceNo": "2b454b5b-3004-4b8e-8acc-e05f7a8d2cd3", // 회원가입 시 클라이언트에서 제공한 traceNo
"userInfo": {
"userKey": "김건우_01043215678", // 클라이언트에서 발급한 파트너키
"newUserYn": "Y" // 제휴사를 통해 첫 가입한 경우 "Y", 기존 트레져러 유저일 경우 "N"
},
"assets": {
"userDeposit": "0" // 트레져러 예치금
}
}{
"traceNo": "20240717051911000", // 회원가입 요청 시 클라이언트에서 제공한 traceNo
"userInfo": {
"userKey": "5654499e-7da2-431b-b745-3807751f91c6", // 트레져러에서 발급한 파트너키를 제휴사 측에서 저장
"newUserYn": "Y" // 제휴사를 통해 첫 가입한 경우 "Y", 기존 트레져러 유저일 경우 "N"
},
"assets": {
"userDeposit": "0" // 트레져러 예치금
}
}생선된 userKey (파트너키)를 활용하여 user hash를 발급받을 수 있으며 해당 키를 활용하여 유저가 로그인되어 있는 상태로 웹뷰에 접속할수 있습니다.
해시키 조회
트레져러 연동 웹뷰 진입에 필요한 해시키를 조회합니다
파트너와 파트너 키를 통하여 해시키를 조회합니다.
해당 해시키를 url 뒤에 사용하여서 해당 유저를 로그인 된 상태로 트레져러 웹뷰에 접속할 수 있습니다.
해시키의 경우 한번 발급하면 1시간동안 사용이 가능합니다.
POST /v1/partners/user/hash
Headers
Content-Type
application/json
Body (Example)
{
"partner": "lpoint", // [Required] 미리 지정된 파트너 스트링 'syrup' | 'kb' | 'lpoint' | 'myb' | 'smartscore'
"userKey" : "5654499e-7da2-431b-b745-3807751f91c6" // [Required] 회원가입 시 발급한 파트너키
}Response (Example)
{
"result": "success",
"message": "success",
"code": 200,
"data": {
"hashKey": "SMARTSCORE_sWrchmFLGebV+5LwN1JdEKLDBmxpOnFB/VMNiBUdujw=" // 트레져러 웹뷰 진입 시 필요한 해시키
}
}유저 자산 조회(GET & POST)
파트너 키를 통하여 유저의 자산을 조회할 수 있습니다.
GET과 POST 두 엔드포인트는 동일하게 작동합니다.
UUID가 아닌 커스텀 파트너키를 사용할 경우 POST 엔드포인트 사용을 권장합니다.
GET/v1/partners/user/asset/gross
POST /v1/partners/user/asset/gross
Headers
Content-Type
application/json
Query Param(GET 요청 시)
source
myb, lpoint 등
partnerKey
가입시 userKey 리턴받은 키값
Query Param Example
source
lpoint
partnerKey
88ad3028-a214-44d5-a58f-6f6cf890c04e
Body (Example)
{
"source": "smartscore", // [Required] 미리 지정된 파트너 스트링 'syrup' | 'kb' | 'lpoint' | 'myb' | 'smartscore'
"partnerKey": "홍길동_01012345678" // [Required] 회원가입 시 발급한 파트너키
}Response
{
"baseTime": "20250117221225",
"historyUrl": "localhost:3000/history",
"assets": {
"userDeposit": "6147407",
"totalValueAmount": "274580.423",
"totalIncome": "158338",
"totalYield": "136.21",
"incomeType": "P"
},
"assetsList": [
{
"goodsId": "100007",
"goodsName": "리쉬부르 그랑 크뤼 2000",
"goodsType": "G",
"brandName": "Domaine Leroy",
"goodsImageUrl": "https://cdn.treasurer.co.kr/trade-item-image/LRYRCB0001/3b883706-2c2f-4608-ad36-f46f8481ad6a_thumbnail.png",
"detailLinkUrl": "localhost:3000/item/100007",
"valueAmount": "141747",
"incomeType": "P",
"assetsCount": "111",
"incomeAmount": "140316",
"yield": "9805.45",
"goodsStatus": "",
"message": "",
"messageLinkUrl": ""
},
{
"goodsId": "1001",
"goodsName": "금",
"goodsType": "K",
"brandName": "Treasurer",
"goodsImageUrl": "https://cdn.treasurer.co.kr/trade-item-image/GOLD0001/24e97984-7eb2-4544-9054-2197278800aa_thumbnail.png",
"detailLinkUrl": "localhost:3000/item/1001",
"valueAmount": "71721",
"incomeType": "P",
"assetsCount": "5802",
"incomeAmount": "12195",
"yield": "20.49",
"goodsStatus": "",
"message": "",
"messageLinkUrl": ""
}
]
}Last updated