암호화된 사용자 정보를 기반으로 상대 거래소의 가입여부를 확인 합니다.

CODE-Cipher의 응답된 데이터를 기반으로, 거래소의 전달자 가입 여부를 확인합니다.

개인정보는 이름과 생년월일 정보이며 Originator 거래소에서 CODE-Cipher를 통해 단방향 암호화되어 있습니다.
개인정보가 저장되거나 유출될 우려가 없습니다.

입고, 출고 구분 없이 같은 API를 사용합니다. 차이점은 온체인 TXID의 유무입니다.
입고를 받으시는 경우 TXID가 존재하며, 출고 시에는 아직 온체인 트랜잭션이 일어나지 않았으므로 TXID가 없습니다.

🚧

Body 전문은 CODE-Cipher API에 응답된 데이터를 사용합니다. CODE-Cipher 응답값 조작 시 정상적인 통신이 불가할 수 있습니다.

Path Parameter

이름필수 여부타입설명
entityId필수string상대 VASP의 entityId로 ID Connect VASP 목록 조회로 획득 가능

Request

이름필수 여부타입
fullName필수string
dateOfBirth필수string
hashSalt필수string
accountNumber필수string
tag옵션string
currency필수string
txId옵션 or 필수string
requestId필수string

fullName: 암호화된 전달자 성명입니다.


dateOfBirth : 암호화된 전달자 생년월일입니다.


hashSalt: salt 입니다.


accountNumber: 가상자산 지갑 주소입니다. 문자열 서식은 ID Connect 페이지의 Sample Data를 참고해 주세요.


tag: 특정 블록체인 네트워크에서 사용자의 거래를 구분하기 위해 필요한 식별자입니다.


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


network: 블록체인 네트워크의 심볼입니다. 문자열 서식은 ID Connect 페이지의 Sample Data를 참고해 주세요.


txId: 블록체인 트랜잭션 아이디로 블록체인 수신(입고) 시에는 필수입니다. 문자열 서식은 ID Connect 페이지의 Sample Data를 참고해 주세요.


requestId: unique 요청 ID, UUID v4

{
    "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" : ""
}

Response

이름필수 여부타입
result필수string
requestId옵션string
reasonMsg옵션string
reasonType옵션string

result: 요청된 매칭 정보의 결과입니다.

-VALID: 매칭

-INVALID: 매칭 정보없음


requestId: 요청 트래픽 고유아이디, 사용자가 없을 경우 응답되지 않습니다.


reasonMsg : INVALID인 경우 상세 메시지를 정의합니다.


reasonType: result 필드값이 invalid 인 경우에만 이 필드가 추가 됩니다.

-ADDRESS_NOT_FOUND: 가상자산 주소를 찾을 수 없는 경우입니다.

-TXID_NOT_FOUND: TXID를 찾을 수 없는 경우입니다.

-NAME_MISMATCH: 실제 소유자의 이름과 일치하지 않는 경우입니다. (가상자산 주소는 일치)

-DOB_MISMATCH: 실제 소유자의 생년월일과 일치하지 않는 경우입니다. (가상자산 주소는 일치)

-NAME_DOB_MISMATCH: 실제 소유자의 이름, 생년월일 이 일치하지 않는 경우입니다. (가상자산 주소는 일치)

-UNKNOWN: 그 밖의 다른 이유입니다.

Example

Language