API 동작 명세

요청의 transferId 에 해당하는 자산 이전 내역을 찾아서, status 를 업데이트 합니다.
canceled 는 이전 status 가 denied 또는 완전히 종료되지 않은 상태를 취소하고 종료로 변경할 수 있습니다.
만약, 블록 생성 후 컨펌이 완료되어 상태를 변경할 수 없는 transferId에 대해 송신 VASP 측에서 종료(취소) 요청을 보낸다면 ILLEGAL_STATEFLOW 에러를 반환합니다.
자산 이전 내역의 상태가 canceled 인 경우에 다시 canceled 로 변경하는 것을 허용합니다.

Request

transferId: '자산 이전 허가 요청' 에 부여한 UUID 입니다. 해당하는 트랜잭션에 대한 자산 반영 결과를 알립니다.

status: 가상 자산이 사용자 계정에 반영되었는지에 대한 상태를 나타냅니다.

-canceled: 블록체인 트랜잭션을 보내지 않고 취소한 상태 혹은 보냈는데 취소한 상태입니다. (영구히 취소된 경우)

reasonType: status 가 canceled 일 때 이유를 보여줍니다. (reasonType 은 주소 조회와 자산 이전 요청 API 와 같습니다. 불필요한 항목이 포함돼 있을 수 있으니 사용하지 않으시면 됩니다.)

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

-NOT_SUPPORTED_SYMBOL: 거래할 수 없는 화폐 심볼입니다.

-NOT_KYC_USER: 소유자가 KYC 인증을 진행하지 않은 경우입니다.

-SANCTION_LIST: 가상 자산 주소 또는 소유자가 수취 VASP 의 제재 대상입니다.

-LACK_OF_INFORMATION: 자산 이전을 결정하는데 필요한 정보가 없을 경우입니다.

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

{
  "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002",
  "status": "canceled",
  "reasonType": "LACK_OF_INFORMATION"
}

transferId: 모든 API 에서 자산 이전 트랜잭션을 구별하기 위한 고유 값입니다. (검증 결과에 CodeVASP 가 생성)

result: 요청에 대한 처리 결과입니다.

-normal: 요청을 정상적으로 처리하여, 전달받은 자산 이전 내역의 상태를 종료로 변경한 경우입니다. 이미 종료한 자산 이전 내역에 대해서 다시 종료를 요청하는 것을 허용합니다.

-error: 상태 변경이 불가능한 경우입니다.

reasonType: result 값이 error 인 경우 상세 이유를 구분하는 값입니다.

-UNKNOWN_TRANSFER_ID: Transfer ID 를 찾을 수 없는 경우입니다.

-ILLEGAL_STATEFLOW: 허용되지 않는 상태 흐름입니다. 현재 상태에서 업데이트 하려는 상태로 변경이 허용되지 않는 경우입니다.

-UNKNOWN: 기타 오류입니다. VerifyVASP 는 reasonType 을 반환하지 않기 때문에 여기에 해당합니다.

{
  "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002",
  "result": "error",
  "reasonType": "ILLEGAL_STATEFLOW"
}