수신하는 VASP 에게 자산 이전 내역의 상태를 변경할 것을 요청합니다.
자산을 전송하는 VASP 측에서 자산 이전 프로세스가 중단되거나 실패한 경우, 상대 VASP는 이 상황을 알 수 없기 때문에 무한 대기 상태에 빠질 수 있습니다. 이를 방지하기 위해 '자산 이전 종료' API를 통해 상대 VASP에게 이 사실을 알립니다.
본 API 는 자산을 이전하는 VASP 가 다음의 경우에 호출합니다.
- 자산을 전송하는 VASP 가 '자산 이전 허가 요청' 에서 verified 응답을 받았으나, 내부 판단에 의해서 실제 블록체인 상에서 자산 이전을 실행하지 않고 프로세스를 종료할 경우 이를 상대 VASP 에 알려주기 위하여 사용합니다.
- 블록체인 상에서 자산 이전 트랜잭션이 진행되다가 실패한 경우, 이를 상대 VASP 에 알려주기 위해 사용합니다.
본 API를 호출하는 VASP는 반드시 대상 VASP의 응답이 성공인지 실패인지 확인할 수 있어야 합니다. 만약, 오류를 수신하거나 요청 타임아웃이 발생한 경우에는 주기적인 재시도 로직을 수행해서 다시 요청을 보내도록 구현해야 합니다. 이를 위해서 같은 상태로의 변경 시도는 성공으로 간주합니다.
동기 방식으로 작동하는 API로 요청 후 즉시 응답을 받을 수 있습니다.
Path Parameter
| 이름 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| BeneficiaryVaspEntityId | 필수 | string | 수신 지갑을 소유하는 VASP의 entityId |
Request
| 이름 | 필수 여부 | 타입 |
|---|---|---|
| transferId | 필수 | string |
| status | 필수 | string |
| reasonType | 옵션 | string |
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": "SANCTION_LIST"
}Response
| 이름 | 필수 여부 | 타입 |
|---|---|---|
| transferId | 필수 | string |
| result | 필수 | string |
| reasonType | 옵션 | string |
transferId: 모든 API 에서 자산 이전 트랜잭션을 구별하기 위한 고유 값입니다.(검증 결과에 CODE 가 생성)
result: 요청에 대한 처리 결과입니다.
-normal: 요청을 정상적으로 처리하여, 전달받은 자산 이전 내역의 상태를 종료로 변경한 경우입니다. 이미 종료한 자산 이전 내역에 대해서 다시 종료를 요청하는 것을 허용합니다.
-error: 상태 변경이 불가능한 경우입니다.
reasonType: result 값이 error 인 경우 상세 이유를 구분하는 값입니다.
-UNKNOWN_TRANSFER_ID: Transfer ID 를 찾을 수 없는 경우입니다.
-ILLEGAL_STATEFLOW: 허용되지 않는 상태 흐름입니다. 현재 상태에서 업데이트 하려는 상태로 변경이 허용되지 않는 경우입니다.
-UNKNOWN: 기타 오류입니다. VerifyVASP 는 reasonType 을 반환하지 않기 때문에 여기에 해당합니다.