수신 측 VASP가 송신 측 VASP에게 트랜잭션 상태 조회를 요청합니다.
자산을 수신하는 VASP가 송신 측에서 시작한 블록체인 트랜잭션의 상태값을 알아야 할 때 호출 할 수 있습니다.
이 API 는 상대 VASP 의 자산 이전 내역을 조회하는 API 가 아니며, 수취 VASP 가 송금 VASP 의 블록체인 트랜잭션 상태를 알기 위한 API 로 다음과 같은 경우에 사용할 수 있습니다.
- 수취 VASP 에서 블록체인 상 자산 이전 트랜잭션이 발생하고 사용자의 자산 정보에 반영하기 전에, 자신의 자산 이전 정보의 상태가 confirmed 가 아닐 경우, 송신 VASP 에 해당 자산 이전 건의 트랜잭션 상태를 요청하고 싶은 경우
- '자산 이전 허가 요청' 에 대한 응답을 보냈는데 자산 이전이 실행되지 않을 때, 송신측 VASP 에 해당 건의 트랜잭션 상태를 요청하고 싶은 경우
❗️동기 방식으로 작동하는 API로 요청 후 즉시 응답을 받을 수 있습니다.
Path Parameter
| 이름 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| OriginatingVaspEntityId | 필수 | string | 수신 지갑을 소유하는 VASP의 entityId |
Request
| 이름 | 필수 여부 | 타입 |
|---|---|---|
| transferId | 필수 | string |
transferId: 자산 이전 허가 요청에 부여한 UUID 입니다. 해당하는 트랜잭션에 자산 이전 결과를 업데이트합니다.
{
"transferId": "b09c8d00-8da9-11ec-b909-0242ac120002"
}
Response
| 이름 | 필수 여부 | 타입 |
|---|---|---|
| transferId | 필수 | string |
| status | 필수 | string |
| txid | 필수 or 옵션 | string |
| vout | 옵션 | string |
transferId: 모든 API 에서 자산 이전 트랜잭션을 구별하기 위한 ID 입니다.
status: 상대 VASP에서 관리하는 자산 이전 트랜잭션의 상태입니다.
-pending: 어떤 이유에서든 아직 블록체인 트랜잭션을 보내지 않고 대기하고 있는 상태입니다.
-processing: 블록체인에 트랜잭션을 전송했지만 채굴 대기 중인 상태입니다.
-wait-confirm: 블록체인 트랜잭션이 채굴이 된 것을 확인했지만 아직 finality 를 확보하지 못한 상태입니다.
-confirmed: 블록체인 트랜잭션이 채굴되었고 finality 도 확보된 상태입니다.
-canceled: 블록체인 트랜잭션을 보내지 않고 취소한 상태 혹은 보냈는데 취소한 상태입니다. (영구히 취소된 경우)
txid: 가산 자산 이전에 대해서 생성된 트랜잭션 ID 입니다. 각 블록체인 상에 생성된 정보입니다. Status가 'confirmed'인 경우 필수입니다.
vout: utxo타입 코인의 경우 복수의 txid 생성이 가능하여 유일한 txid를 구분하기 위한 vout가 필요합니다.