파트너사 가입 및 인증

파트너사 회원가입

POST /v1/partners/signup

파트너사의 회원 가입을 처리합니다.

  • 필수 정보를 입력받아 파트너사 계정을 생성합니다.

  • 파트너키는 사전 협의에 따라 UUID(트레져러 발급) 또는 커스텀 형식(제휴사 발급)으로 상호 저장/관리합니다.

  • 생성 완료 시 파트너사 식별 정보를 반환합니다.

Headers

Name
Value

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)

생선된 userKey (파트너키)를 활용하여 user hash를 발급받을 수 있으며 해당 키를 활용하여 유저가 로그인되어 있는 상태로 웹뷰에 접속할수 있습니다.

해시키 조회

트레져러 연동 웹뷰 진입에 필요한 해시키를 조회합니다

  • 파트너와 파트너 키를 통하여 해시키를 조회합니다.

  • 해당 해시키를 url 뒤에 사용하여서 해당 유저를 로그인 된 상태로 트레져러 웹뷰에 접속할 수 있습니다.

  • 해시키의 경우 한번 발급하면 1시간동안 사용이 가능합니다.

POST /v1/partners/user/hash

Headers

Name
Value

Content-Type

application/json

Body (Example)

Response (Example)

유저 자산 조회(GET & POST)

파트너 키를 통하여 유저의 자산을 조회할 수 있습니다.

  • GET과 POST 두 엔드포인트는 동일하게 작동합니다.

  • UUID가 아닌 커스텀 파트너키를 사용할 경우 POST 엔드포인트 사용을 권장합니다.

GET/v1/partners/user/asset/gross

POST /v1/partners/user/asset/gross

Headers

Name
Value

Content-Type

application/json

Query Param(GET 요청 시)

Name
Value

source

myb, lpoint 등

partnerKey

가입시 userKey 리턴받은 키값

Query Param Example

Name
Value

source

lpoint

partnerKey

88ad3028-a214-44d5-a58f-6f6cf890c04e

Body (Example)

Response

Last updated