자산 이전 결과(txid) 전송

전송 받은 자산 이전 결과 (Transaction ID) 를 해당 자산 이전 내역에 반영합니다.

POST /v1/beneficiary/transfer/txid

가상자산을 전송하는 VASP 는 블록체인 상에서 자산 이전을 실행하고 생성되는 트랙잭션 결과를 수취 VASP 에 전송하는데, 이 결과를 수신하기 위한 API 입니다.

API 핸들러 동작 명세

1. 요청으로 전달된 데이터 중 transferId 에 해당하는 자산 이전 정보를 찾습니다.

2. 찾아낸 자산 이전 정보의 txid 값을 업데이트하고, 자산 이전 상태를 confirmed 로 변경합니다.

3. 만약, 업데이트 하려는 transferId 에 이미 txid 값이 있는 경우, 두 값이 다르면 에러를 반환하고 같다면 정상처리된 것으로 응답합니다.

v1.6 까지는 전달받은 Transaction ID 는 블록체인 트랜잭션이 실패하지 않는 단계에서 전달받았지만, 이제는 실패할 수 있습니다. 이 경우 자산을 전송하는 VASP 는 자산 이전 종료 API 를 재차 호출합니다.

REQUEST Body Schema: application/jsonRequest

• transferId(Required): '자산 이전 허가 요청' 에서 부여한 UUID 입니다. 해당하는 자산 이전 내역에 자산 이전 결과 (Transfer ID) 를 저장하기 위해 설정합니다.

• txid(Required): 가상 자산 이전을 위하여 블록체인상에 실행된 특정한 트랜잭션을 식별하기 위한 아이디입니다. 블록체인 API 에 의해서 생성되며 유일한 값입니다.

• vout(Optional): utxo타입 코인의 경우 복수의 블록체인 트랜잭션이 하나의 txid 를 공유하면서 그룹을 형성할 수 있습니다. 이때, 고유한 트랜잭션을 식별하기 위해 이 값을 사용합니다. 마찬가지로 블록체인 API 의 실행 결과물입니다.

{
  "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002"
  "txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
  "vout": ""
}

Response

200 OK

RESPONSE SCHEMA: application/json

• transferId(Required): 모든 API 에서 자산 이전 트랜잭션을 구별하기 위한 ID 입니다.

• result(Required): 송금 정보 수신 결과입니다.

  • normal: 요청을 정상적으로 처리하여 전달받은 Transaction ID 를 저장 완료한 상태입니다.

  • error: 요청을 처리하는 VASP 에서 요청을 처리하지 못한 상태입니다.

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

  • UNKNOWN: 현재 이 API 에서 발생할 것으로 예상되는 에러 사유가 없습니다.

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

  • TRANSFER_ALREADY_FAILED: txid 를 저장하려는 TransferId 에 해당하는 자산 내역이 이미 실패한 경우 txid 를 저장할 수 없습니다.

  • TXID_ALREADY_EXISTS: 이미 txid 가 저장된 자산 이전 내역에 대해서 다른 txid 를 저장하도록 요청받은 경우입니다. txid 가 한번 생성되면 실패할 수는 있지만 변경되지는 않습니다.

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