ID Connect

ID Connect 요건에 맞게 사용자 정보 암호화 및 필요 정보를 구성합니다.

POST /api/v1/code/connect/hash

Response에서 받은 Body값을 그대로 다음 API(본인 인증)에 사용합니다.

이름은 성, 이름이 반드시 분리되어있어야 합니다. 한글/영문 모두 가능하나 반드시 각 VASP의 이름이 동일 해야합니다.

Input Body

• firstName (Required): 이름

• lastName (Required): 성

• dateOfBirth (Required): 생년월일(예: 1990-01-01)

  • 형식이 반드시 일치해야합니다. yyyy-MM-dd 형식으로 해주세요.

• accountNumber (Required): 가상 자산 지갑 주소 (beneficiary address)

  • 요청자의 가상 지갑 주소.

  • 예를들어 VASP A 에서 VASP B 요청 시, VASP A 주소를 넣고, 반대로 VASP B 에서 VASP A 로 보낼때는 VASP A주소를 넣어야 합니다.

• tag (Optional): 가상 자산 2차 주소 (예: XRP의 메모)

• currency : (Required): 가상 자산의 심볼. (예: Ethereum 또는 Ether 대신 ETH)

• network (Optional): 블록체인 network (VASP List API에 enum이 제공 됩니다)

• txId (Optional): 블록체인 트랜잭션 아이디

  • 블록체인 수신(입금) 시 (Required)

• requestId (Required): unique 요청 ID

  • UUID v4

{
    "txId": "b170572d0-8b48-425c-b062-bd93f6a1cf90",
    "firstName": "Simon",
    "lastName": "Sanderson",
    "dateOfBirth": "1999-01-01",
    "accountNumber": "mifKeopCpgYhQiXK9kgeT4nFnzgc36zWxB",
    "network": "BTC",
    "currency": "BTC",
    "requestId": "681f27dd-43e4-4ea3-9bcc-607426d6349f",
    "tag": ""
}

Example Request

curl --location 'localhost:8787/api/v1/code/connect/hash' \
--data '{
    "txId": "b170572d0-8b48-425c-b062-bd93f6a1cf90",
    "firstName": "Simon",
    "lastName": "Sanderson",
    "dateOfBirth": "1999-01-01",
    "accountNumber": "mifKeopCpgYhQiXK9kgeT4nFnzgc36zWxB",
    "network": "BTC",
    "currency": "BTC",
    "requestId": "681f27dd-43e4-4ea3-9bcc-607426d6349f",
    "tag": ""
}'

Example Response

200 OK

{
    "signature": "9z7d4n3w4DQUjdbbRmRfDPxnGFRZG0JikUO/RS1Lw0JuZSep8BDYjZPu6p/2Ul5a3z8JlPX6jFlIPqjx1yrlDA==",
    "nonce": 1258508432,
    "dateTime": "2023-07-28T01:26:16Z",
    "publicKey": "SK7C3UW65sKd8MqSwtbPW4evbUJ9NHTrksXg/pFjERg=",
    "body": "{\"fullName\":\"0257d352a0f459ac484559de4d3e95860504e1004c48ce3179c4eef79d34e9de\",\"dateOfBirth\":\"fcde00b12839f0529c9d00048f80f8b0ce8e1da7d1807d2da2847b099c8b123b\",\"hashSalt\":\"ad30d9ef-780e-4449-886b-d6c371cd3473\",\"network\":\"BTC\",\"txId\":\"b170572d0-8b48-425c-b062-bd93f6a1cf90\",\"requestId\":\"681f27dd-43e4-4ea3-9bcc-607426d6349f\",\"currency\":\"BTC\",\"accountNumber\":\"mifKeopCpgYhQiXK9kgeT4nFnzgc36zWxB\",\"tag\":\"\"}"
}

400 Bad Request

{
  "errorType": "MISSING_REQUIRED_MSG_FIELD",
  "errorMsg": "[requestId is required and not allow empty value]"
}