Changelog
v2.0 2024.06.04
- TXID로 VASP찾기 기능이 추가 되었습니다.
- 요청API
- TXID로 VASP 찾기 요청, TXID로 VASP 찾기 결과 조회, 자산 이전 데이터 요청
- 응답 API
- TXID로 VASP 찾기, 자산 이전 데이터 요청
- 요청API
v1.9.1 2024.02.26
- 주소로 VASP찾기 기능이 추가 되었습니다
- 요청API
- 주소로 VASP 찾기 요청, 주소로 VASP 찾기 결과 조회
- 요청API
v1.9 2023.08.10
- IVMS101 이름 표기법의 내용이 수정되었습니다.
- 해외 VASP 와 거래하는 경우 영문 이름이 없을 때 음역에 관한 내용이 제거되었습니다.
- IVMS101 수취인 이름 검증에 대한 내용이 보완되었습니다.
- nameIdentifier와 localNameIdentifier에 대한 비교 내용이 추가되었습니다.
- nameIdentifier가 공백("")인 경우에 대한 내용이 추가되었습니다.
v1.8 2023.07.05
- CODE-Cipher 모듈에 대한 설명이 추가 되었습니다.
- UI 가이드 및 연동 가이드가 추가 되었습니다.
v1.7
- '자산 이전 결과(txid) 전송' CODE API, VASP API 명세를 수정했습니다.
- 해당 API 의 호출 시점이 블록체인 트랜잭션이 실패하지 않음을 보증할 수 있는 시점에서 Transaction ID 를 획득한 직후로 변경됐습니다.
- API 를 통한 정보 전달을 보장하기 위한 동작 명세가 추가되었습니다.
- 이 후 블록체인 트랜잭션이 진행되는 과정에서 실패하는 경우에는 자산 이전 종료 API 를 추가로 호출합니다.
- 응답의 reasonType 이 추가됐습니다.
- '자산 이전 종료' 요청 API, 응답 API 명세를 수정했습니다.
- API 를 사용하는 상황과 호출하는 쪽에서 구현해야 하는 동작이 변경됐습니다
v1.6
- Header Parameter 명세 수정를 수정했습니다.
- X-Code-Req-Remote-Pubkey 가 새롭게 추가됐습니다. 메시지를 암호화할 때 사용한 상대 VASP 의 Public Key 입니다. 만약, 암호화를 하지 않았을 경우에는 생략합니다.
- 오류에 새 항목을 추가했습니다.
- INVALID_RECEIVER_PUBLIC_KEY
- ILLEGAL_FORMAT_OF_ORIGIN
- INVALID_ORIGIN
- UNACCEPTABLE_REQUEST
- API 명세에 VerifyVASP 와 연동이 됨에 따라서 변경되는 내용을 추가했습니다.
- VASP 목록 조회 API 에 대한 설명을 보완했습니다.
- 공개키 목록 조회 API 에 대한 설명을 보완했습니다.
- '가상 자산 주소 조회' 요청에 수취인 이름이 포함 있으면 '자산 이전 허가 요청' 과 마찬가지로 이름 검증을 실시합니다. 아직은 VerifyVASP 에서 들어오는 요청을 처리하기 위한 명세이기 때문에 전역 조회가 아닌 거래소 지정 조회일 때만 해당합니다. CODE 내부 거래소에 대해서는 v1.6 명세를 지원하지 않는 거래소는 지원하지 않습니다.
- '가상 자산 주소 조회' 요청의 응답(response) reasonType 에 INPUT_NAME_MISMATCHED 를 추가 하였습니다.
- VerifyVASP 가 보내는 '자산 이전 허가 요청' 은 payload 밖에 originatingVasp 정보가 있는 점을 반영했습니다. (철자에 유의해 주세요.)
- VerifyVASP 가 보내는 '자산 이전 허가 요청' 응답(response)은 payload 밖에 beneficiaryVasp 객체가 있는 점을 명시했습니다. (철자에 유의해 주세요.)
- '자산 이전 종료' API 의 beneficiary-confirmed, beneficiary-denied 상태를 사용할 수 없습니다. 수신 VASP 로 전달하지 않고, CODE 서버가 대신 200 OK 를 응답합니다. 수신 VASP 의 상태가 바뀌지 않습니다.
- '자산 이전 종료' API 의 응답(response) 의 reasonType 에 UNKNOWN 을 추가했습니다. VeirifyVASP 가 오류를 응답하는 경우 reasonType 이 없기 때문에 UNKNOWN 이 반환됩니다.
v1.5
- 이름(nameIdentifier) 표기법 내용을 수정했습니다.
- 국내 VASP 끼리 거래하는 경우, localNameIdentifier 에 영문 이름을 기입합니다.
- 수취인 이름 검증을 요청하는 경우는 성과 이름을 분리해서 기입해주세요.
- Body 샘플을 수정했습니다.
- Error Report 섹션의 설명을 수정했습니다.
- RECEIVED_WRONG_JSON_MESSAGE 오류 메시지를 추가했습니다.
- RECEIVED_MSG_MISSING_FIELD 오류 메시지를 추가했습니다.
- RECEIVED_WRONG_JSON_MESSAGE 오류 메시지를 추가했습니다.
v1.4
- '가상자산 주소 조회' 요청(request) 메시지 샘플의 잘못된 내용 수정했습니다.
- '자산 이전 허가 요청' 의 필드 설명을 보완하였습니다.
- '자산 이전 허가 요청' 과 응답(response) 메시지 샘플의 nameIdentifier 와 LocalNameIdentifier 필드가 명세와 맞지 않거나 이해하기 어려운 부분 수정하였습니다.
- 오류 응답
- 503 -> INVALID_ENCRYPTED_BODY 오류 추가 했습니다. 복호화 할 수 없는 BODY 메시지일 때 반환합니다.
- 이름 표기법의 이름 비교하는 규칙을 수정하였습니다.
v1.3
- 헤더 X-Code-Req-Nonce 의 동작을 변경하였습니다.
- Nonce 값은 CODE 서버에서만 검사하며, 1분내에 중복된 값이 들어오는 경우, 422 Validation error: DUPLICATED_HEADER_NONCE 오류를 반환합니다.
- 메시지 암호화 및 Signing 에 대한 설명 추가했습니다.
- CODE 서버가 Signature 검증에 실패한 경우, 422 Validation error: INVALIDE_HEADER_SIGNATURE 오류를 반환합니다.
- 'VASP 목록 조회' API를 수정하였습니다.
- 응답 포맷이 변경되었습니다.
- health, country -> countryOfRegistration, allianceName (code, vv(verifyvasp)) 추가
- '가상 자산 주소 조회' API를 수정했습니다.
- 명세가 CODE API 와 VASP API 에서 다른 부분을 수정했습니다.
- 메시지 포맷의 vaspEntityId -> beneficiaryVaspEntityId 로 변경했습니다.
- 응답 메시지 중 BeneficiaryVaspEntityId 필드를 Optional 에서 Required 로 변경하고 응답하는 쪽에서는 이 요청이 Unicast 인지 Broadcast 인지 알수 없기 때문에 Broadcast 를 기준으로 작성하였습니다.
- reasonType 에 LACK_OF_INFORMATION 을추가했습니다.
- reasonType 에 NOT_SUPPORTED_SYMBOL 을 추가했습니다.
- '자산 이전 허가 API 를 수정했습니다.
- Request Body -> beneficiary 객체에 대한 설명을 포맷에 맞게 수정했습니다.
- beneficiaryPersons 객체에 대한 설명을 보완했습니다.
- 요청 메시지에 tradePrice, tradeCurrency, isExceedingThreshold 필드를 추가했습니다.
- 응답 메시지에서 currency, amount, historicalCost 를제거했습니다.
- 요청 메시지와 응답 메시지의 이름 입력하는 샘플을 수정했습니다.
- result 필드 설명에 sanctionlist 잘못 들어가 있는 것 삭제했습니다.
- reasonType 에 LACK_OF_INFORMATION 을추가했습니다.
- reasonType 에 NOT_SUPPORTED_SYMBOL 을추가했습니다.
- 자산 이전 상태 변경 API를 수정했습니다.
- 이름을 '자산 이전 종료' API 로 변경하고 명세 변경했습니다.
- API 를 자산 이전 상태를 변경하기 위한 목적이 아닌 최종 종료 상태로 변경하기 위한 API 로 변경했습니다.
- reasonType 요소를추가했습니다.
- 오류 응답을 추가했습니다.
- 429 Too Many Requests 오류 추가했습니다.
- '트랜잭션 상태 조회' API 명세 변경했습니다.
- API 설명 변경했습니다.
- status 필드 종류 변경했습니다.
- txid 필드 required -> optional 로 변경했습니다.
- 헬스 체크 API 추가했습니다.
v1.2
- IVMS101 메시지 법인정보/이름 표기법을 추가했습니다.
- 메시지 암호화 -> 응답 사이닝 설명을 제거했습니다.
- 503 오류 타입을 추가했습니다.
- 자산 이전 정보에 대한 설명을 추가했습니다.
- 'VASP 목록 조회' API URL 변경했습니다.
- 'VASP 목록 조회' API 응답 포맷에 VASP 등록 국가를 의미하는 country 필드를 추가 했습니다.
- '가상 자산 주소 조회' API 의 result 필드 값에서 sanctionlist 를 invalid 로 통합했습니다.
- '자산 이전 허가 요청' API 의 result 필드 값에서 sanctionlist 를 denied 로 통합했습니다.
- '자산 이전 허가 요청' API 의 reasonType 에 INPUT_NAME_MISMATCHED 를가했습니다.
- '트랜잭션 상태 변경' API 의 result 값과 reasonType 값을 추가했습니다.
- 메시지 필드의 originResponse 를제거했습니다.
Updated 23 days ago