CODE-Cipher를 사용하여 Header와 Payload를 생성하는 방법을 설명합니다.

Travel Rule API 요청의 경우 Header, Body에 입력할 데이터를 암호화하여 응답으로 제공합니다. API 종류별로 해당 Travel Rule API에 대해 전달받은 값을 그대로 사용하면 편리합니다.

apiType ENUM은 다음과 같습니다.:

- SEARCH_VASP_LIST : VASP 목록 조회, ID Connect VASP 목록 조회

- SEARCH_PUBKEY_LIST : 공개키 조회

- SEARCH_ADDRESS_REQUEST : 주소로 VASP 찾기 요청

- SEARCH_ADDRESS_RESULT : 주소로 VASP 찾기 결과 조회

- SEARCH_ADDRESS : 가상자산 주소 조회

- TRANSFER_AUTHORIZATION : 자산 이전 허가 요청

- REPORT_TRANSFER_RESULT : 자산 이전 결과(txid) 전송

- SEARCH_TRANSACTION_STATUS : 트랜잭션 상태 조회

- FINISH_TRANSFER : 자산 이전 종료

- SEARCH_TRANSACTION_ID : TXID로 VASP찾기 요청

- FETCH_TRANSACTION_ID : TXID로 VASP찾기 결과 조회

- VERIFICATION_TRANSACTION_ID : 자산 이전 데이터 요청



VASP 목록 조회

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_VASP_LIST 입력
{
    "allianceName": "CODE",
    "apiType": "SEARCH_VASP_LIST"
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
{
  "signature": "siBkH9hov/7yfU8bedguB0mMIdt04DQUnB85mVPpzrMr8i+SYl3Pn46U2kvjrxEzwCSaH5E5W0nFsPyRfHbNCw==",
  "nonce": 803400752,
  "dateTime": "2023-06-21T05:25:52Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo="
}

공개키 조회

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_PUBKEY_LIST 입력
{
    "allianceName": "CODE",
    "apiType": "SEARCH_PUBKEY_LIST"
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
{
  "signature": "ouCcxqhDtsU4N9nN05QP6J6gJoJsZqilsj296C2bRNAMB1MCmVVChJ7OkhU0SVdQWaDMg3YMLZmgMr2yJfpMDQ==",
  "nonce": 1727097200,
  "dateTime": "2023-06-21T05:25:28Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo="
}

주소로 VASP 찾기 요청

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_ADDRESS_REQUEST 입력
request필수요청 Body
{
    "allianceName": "CODE",
    "apiType": "SEARCH_ADDRESS_REQUEST",
    "request": {
        "currency": "XRP",
        "beneficiaryWalletAddress": "0x1234567890123456789012345678901234567890",
        "requestId": "fafd59e2-aff7-4cff-b7d8-9caa0cda70da"
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"currency\":\"XRP\",\"addressNumber\":\"rHcFoo6a9qT5NHiVn1THQRhsEGcxtYCV4d:memo or tag\",\"requestId\":\"fafd59e2-aff7-4cff-b7d8-9caa0cda70da"}"
}

주소로 VASP 찾기 결과 조회

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_ADDRESS_RESULT 입력
{
    "allianceName": "CODE",
    "apiType": "SEARCH_ADDRESS_RESULT"
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo="
}

가상자산 주소 조회

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_ADDRESS 입력
remotePublicKey필수수신 하는 VASP의 Public Key
request필수요청 Body
{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "SEARCH_ADDRESS",
    "request": {
        "currency": "XRP",
        "beneficiaryWalletAddress": "0x1234567890123456789012345678901234567890",
        "beneficiaryFirstName": "code", // optional
        "beneficiaryLastName": "vasp", // optional
        "beneficiaryLocalFirstName": "코드", // optional
        "beneficiaryLocalLastName": "거래소", // optional
        "beneficiaryLegalName": "test", // optional
        "nameIdentifierType": "LEGL" // optional
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"currency\":\"XRP\",\"payload\":\"7UGcPV9aZ+NGZNdeV31eXyuEpQKHPA0kjaFvcUt9f8BIXG7IrkqiG2sXBqF9KZC5CZBAZ4xqnlHl2+ZSjqNSw9lm08y55NQTkIPNMHjdpsWCOItg4j5G+HDy2k8pZxmRZP7nVI6OkquJ7oB0jz31GL5uIPZd76NaBzOVy9dXe/Kp/lvTqGQj+TdD+v9C7Ez0fkOY+VPvQkzzBRlb\"}"
}

자산 이전 허가 요청

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수TRANSFER_AUTHORIZATION 입력
remotePublicKey필수수신 하는 VASP의 Public Key
request필수생성된 Body
{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "TRANSFER_AUTHORIZATION",
    "request": {
        "amount": "0.00001",
        "tradePrice": "55555",
        "transferId": "qwewq51312",
        "tradeCurrency": "KRW",
        "historicalCost": "",
        "currency": "BTC",
        "originatingVasp": {},
        "isExceedingThreshold": true,
      
        // optional for GTR,Sygna
        "address": "",
        "tag":"",
        "network":"",
      
        // originator
        "originatorNaturalPersonLastName": "Barnes",
        "originatorNaturalPersonFirstName": "Robert",
        "originatorNaturalPersonLocalLastName": "반스",
        "originatorNaturalPersonLocalFirstName": "로버트",
        "originatorLegalName": "(주)코인원",
        "originatorLegalPersonLastName": "Kim",
        "originatorLegalPersonFirstName": "Chulsu",
        "originatorLegalPersonLocalLastName": "김",
        "originatorLegalPersonLocalFirstName": "철수",
        "nameIdentifierType": "LEGL",
        "customerIdentification": "3213213qweqwe213312",
        "originatorWalletAddress": "012345678900",
        "originatorNaturalPersonDob": "1990-01-01", // optional for GTR, Sygna
      
        // originatingVasp
        "originatingVaspCountryOfRegistration": "KR",
        "originatingVaspLegalName": "Korbit Inc.",
        "originatingVaspNameIdentifierType": "LEGL",
        "originatingVaspAddressType": "GEOG",
        "originatingVaspTownName": "Seoul",
        "originatingVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "originatingVaspCountry": "KR",
        "originatingVaspNationalIdentifier": "1234567890",
        "originatingVaspNationalIdentifierType": "RAID",
        "originatingVaspRegistrationAuthority": "RA000657",
      
        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryNaturalPersonDob": "1990-01-01", // optional for GTR, Sygna
        "beneficiaryLegalName": "(주)코인원",
        "beneficiaryLegalPersonLastName": "Kim",
        "beneficiaryLegalPersonFirstName": "Minsu",
        "beneficiaryLegalPersonLocalLastName": "김",
        "beneficiaryLegalPersonLocalFirstName": "민수"
        
    }
}
{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "TRANSFER_AUTHORIZATION",
    "request": {
        "amount": "0.00001",
        "tradePrice": "55555",
        "transferId": "qwewq51312",
        "tradeCurrency": "KRW",
        "historicalCost": "",
        "currency": "BTC",
        "originatingVasp": {},
        "isExceedingThreshold": true,
        // originator
        "originatorNaturalPersonLastName": "Barnes",
        "originatorNaturalPersonFirstName": "Robert",
        "originatorNaturalPersonLocalLastName": "반스",
        "originatorNaturalPersonLocalFirstName": "로버트",
        "originatorLegalName": "(주)코인원",
        "originatorLegalPersonLastName": "Kim",
        "originatorLegalPersonFirstName": "Chulsu",
        "originatorLegalPersonLocalLastName": "김",
        "originatorLegalPersonLocalFirstName": "철수",
        "nameIdentifierType": "LEGL",
        "customerIdentification": "originatorCustomerIdentification",
        "originatorWalletAddress": "012345678900",
        // originatingVasp
        "originatingVaspCountryOfRegistration": "KR",
        "originatingVaspLegalName": "Korbit Inc.",
        "originatingVaspNameIdentifierType": "LEGL",
        "originatingVaspAddressType": "GEOG",
        "originatingVaspTownName": "Seoul",
        "originatingVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "originatingVaspCountry": "KR",
        "originatingVaspNationalIdentifier": "1234567890",
        "originatingVaspNationalIdentifierType": "RAID",
        "originatingVaspRegistrationAuthority": "RA000657",
        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryLegalName": "(주)코인원",
        "beneficiaryLegalPersonLastName": "Kim",
        "beneficiaryLegalPersonFirstName": "Minsu",
        "beneficiaryLegalPersonLocalLastName": "김",
        "beneficiaryLegalPersonLocalFirstName": "민수",
        "beneficiaryCustomerIdentification": "beneficiaryCustomerIdentification",
        // beneficiaryVasp
        "beneficiaryVaspCountryOfRegistration": "KR",
        "beneficiaryVaspLegalName": "Korbit Inc. beneficiaryVaspLegalName",
        "beneficiaryVaspNameIdentifierType": "LEGL",
        "beneficiaryVaspAddressType": "GEOG",
        "beneficiaryVaspTownName": "Seoul",
        "beneficiaryVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "beneficiaryVaspCountry": "KR",
        "beneficiaryVaspNationalIdentifier": "1234567890",
        "beneficiaryVaspNationalIdentifierType": "RAID",
        "beneficiaryVaspRegistrationAuthority": "RA000657"
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
  "signature": "pOCyDvkDsPGq5oU4Of7C2IwFv09Oovbp0tKU2mFoxtXuPPWsTJ/UOUGkebvskTx4PV1z9VFNazmDPcI9A6EFDA==",
  "nonce": 1131014480,
  "dateTime": "2023-06-21T05:25:07Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"transferId\":\"qwewq51312\",\"currency\":\"BTC\",\"amount\":\"0.00001\",\"historicalCost\":\"\",\"tradePrice\":\"55555\",\"tradeCurrency\":\"KRW\",\"isExceedingThreshold\":true,\"originatingVasp\":{},\"payload\":\"6Mxwnomavmz61KaqpcNVTNNKBOiz1zDSeIl6MXwRKehqf24+xpQyd2Jlxz/oQM6U7cCa8FXcLwL3F3u5rDVYA6P9fIK9NWGyFMg5mmKrWjX0nHtUQh9YmKwugRkImOyzY1BIWIDbN2rViVwIyDwScz/G15eZXTR6scZIz+3IlitRNm6xSpjRHwIgKHgrOaYCByBp/igwfw/ejFr9OQkSJZLfCwHCn+YA/mH9syDmONXtLpkK21sE2BMrbCEsXn7NuJFcOGMzjG9itS/FtkM3ppbfntnsrcVg91oaKGoUNkWtsHCVe+yBhUT10yRwXJDb2K1QXVfmirPqZeRfx7o0IjIONi5pqbAqJoKnKqsvypqvnQ3nn+nO9ZuU+DnWWxbJH+H9qp/zpo0WPXzY3utUDEmiVJwKmZHwL45jz48Z4yTcCMdi7FfFCxxnj3dvrCQ4ux9Wqnqu4SpWoEX2NZ4wp9oXh6le9fBX6w4sqw9nMJtEkEOAvj111/6w0I/SDh55BvDNvnyxWW7pCBDrR2egIFFH+NWjl8vMZWJxkpQLfx/TDqLrAxHbOuIV2xFKiwrUFjNx8G6YCeO0hd02vSaZ6AUi9ZFJDUIAcYdTEbBhTDqDdMKiZvXxDTAOjL2mOdk3alOug4Sput5BJs7TYZh9RL0IF/2cR23Cjo6X5CRYC8mAYGb1uPbmEE1LU/pneWDT+aWKAIAo+zlaPksVM+emuYywm84h4rQnDbMHTqSoalbdm5gsbYmjpj121b9JhprBMzZu8NSljUXzhaNI12jEO/ZEPrHfmul2/I1cOn8ldIZswcTCk0heY7D0ytVOkMScWCVPdT4Qhx5z3DUiPVe7swnvcUzRIHAWsyymjtNJ5oiH0muOsItivmuXh96d6ydCVboHIuTF/qS/s8NPWWQGTOavbgDq3k0mRLfO3wXjsbLVH4WnUFPlUaukHPgJurkImJDWaT1+Hu0yp/mK8c+8ZS2XzzSW2vDp+QtvIuRB+q/uih/Vl1IqV7dW4DSW5kyyw3KwrTB5TObufkFR46uKluxqobCeNbmA5ojuUpe+1GUypzZXKplrqVLZRApa/AwmWasVp6RiEXMIm/UMuXSOjb2Q3dR5LX5SxluY18lts2J8EDB7CT/DhGULws+KK3w+iSwVzpVmBQbz3b7KneOIsS2uAwsTPZZl1CW7wnMXCyYwjN9Yzr7juHQ56YgZX/YltAOyMMRfyCJrTApU9ppb++bB4PTjJIsFfW7wBLGJ4As/JrQDnlw51AJEP5bXs7PKYE+QOt4161kv6iaL9U226jIQWgOYD9qXL0H0ek1e4GapX8ttWadgXnp7stYrgSgeiMIIw5EgH3VOu2/hTjhJuRFi3rwbT9bFRAQXSsxD/FviZ07YIzyn4q9hFMBe7SfPQFo54XJLEW3Ze4fbHY/ewL+WUHw9KImYocZejAhV1eP1DdA9oJVHbBrXW9cafIJKRNKYaOSC5j6bUoJAC6v593GBALfp3ehs2q5SZI31gsJSzjhCwmoKHgowoH8ooovQHcIm6wz4icpANHYm40us7Z4caDPjF+JQO8PZcCwmmVKm5vXLQNrAoaHkLMKjWXOKBL/UEgpqam2GZTqAs3kDIpZPSna/5W6wXdPEt0kikiaZvuaR4XZPDGO/JS7Gz7qNECZu0EStRXOQqRe2OHATLMKWJMxfh9XaDNoQLutcQzT5pNiugdGjdi1zRULNSQ==\"}"
}

자산 이전 결과(txid) 전송

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수REPORT_TRANSFER_RESULT 입력
request필수요청 Body
{
    "allianceName": "CODE",
    "apiType": "REPORT_TRANSFER_RESULT",
    "request": {
        "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002",
        "txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
        "vout": ""
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"currency\":\"XRP\",\"payload\":\"7UGcPV9aZ+NGZNdeV31eXyuEpQKHPA0kjaFvcUt9f8BIXG7IrkqiG2sXBqF9KZC5CZBAZ4xqnlHl2+ZSjqNSw9lm08y55NQTkIPNMHjdpsWCOItg4j5G+HDy2k8pZxmRZP7nVI6OkquJ7oB0jz31GL5uIPZd76NaBzOVy9dXe/Kp/lvTqGQj+TdD+v9C7Ez0fkOY+VPvQkzzBRlb\"}"
}

트랜잭션 상태 조회

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_TRANSACTION_STATUS입력
request필수요청 Body
{
    "allianceName": "CODE",
    "apiType": "SEARCH_TRANSACTION_STATUS",
    "request": {
        "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002"
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
  "signature": "5SvoIHj5+sY6vXGVs2RBzVriTvYjhyPMJhzSq4/hJdpv6nC4WCswj7j31arl6BoTuhCa7eaudtyp2JpVVoLGDA==",
  "nonce": 1459904464,
  "dateTime": "2023-06-21T05:24:40Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"transferId\":\"b09c8d00-8da9-11ec-b909-0242ac120002\"}"
}

자산 이전 종료

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수FINISH_TRANSFER 입력
request필수요청 Body
{
    "allianceName": "CODE",
    "apiType": "FINISH_TRANSFER",
    "request": {
        "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002",
        "status": "canceled",
        "reasonType": "SANCTION_LIST"
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
  "signature": "3zfR+ONXteTcs3o7MMT69QyCYbBpXJFhXXqRAo99UxrpAOTQUEpUVffTZ2wRKPSkfxdqEvoNHJlA2PShZBVgBA==",
  "nonce": 1593438672,
  "dateTime": "2023-06-21T05:24:09Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"transferId\":\"b09c8d00-8da9-11ec-b909-0242ac120002\",\"status\":\"canceled\",\"reasonType\":\"SANCTION_LIST\"}"
}

TXID로 VASP 찾기 요청

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수SEARCH_TRANSACTION_ID 입력
request필수요청 Body
{
    "allianceName": "CODE",
    "apiType": "SEARCH_TRANSACTION_ID",
    "request": {
        "txid": "0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674",
        "vout": "0",
        "requestId": "fafd59e2-aff7-4cff-b7d8-9caa0cda70da"
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
    "signature": "JY+mP1kj2zIQAzxUiQtwRrFmt0Rs+DRxYXHdCkpImC3qiPWEqploS8zM6s8r1AX8iiy+gBrcOaC3EdooR+VgBQ==",
    "nonce": 1324920960,
    "dateTime": "2024-05-23T05:16:18Z",
    "publicKey": "sG65Uno5V+Vm6XOXuwSuM5XMn+HgpqOZi+8PGaTIAMM=",
    "body": "{\"txid\":\"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674\",\"requestId\":\"fafd59e2-aff7-4cff-b7d8-9caa0cda70da\",\"vout\":\"0\"}"
}

TXID로 VASP 찾기 결과 조회

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수FETCH_TRANSACTION_ID 입력
{
    "allianceName": "CODE",
    "apiType": "FETCH_TRANSACTION_ID"
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
{
    "signature": "GNAy7n2KrjRiV1Cgbi/ifVbQipchsqFGS5DULqxeYZDgiV+uy3IDpbD5PrwFyUJkDUeq+3O5VbY8m6uAjIfpDA==",
    "nonce": 501286944,
    "dateTime": "2024-05-23T05:16:49Z",
    "publicKey": "sG65Uno5V+Vm6XOXuwSuM5XMn+HgpqOZi+8PGaTIAMM="
}

자산 이전 데이터 요청

Request

이름필수 여부설명
allianceName필수Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType필수VERIFICATION_TRANSACTION_ID 입력
remotePublicKey필수수신 하는 VASP의 Public Key
request필수생성된 Body
{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "VERIFICATION_TRANSACTION_ID",
    "request": {
        "txid":"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674",
        "vout": "0",
        "transferId": "fafd59e2-aff7-4cff-b7d8-9caa0cda70da",
        
        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryLegalName": "(주)코인원",
        "beneficiaryLegalPersonLastName": "Kim",
        "beneficiaryLegalPersonFirstName": "Minsu",
        "beneficiaryLegalPersonLocalLastName": "김",
        "beneficiaryLegalPersonLocalFirstName": "민수",
        // beneficiaryVasp
        "beneficiaryVaspCountryOfRegistration": "KR",
        "beneficiaryVaspLegalName": "Korbit Inc. beneficiaryVaspLegalName",
        "beneficiaryVaspNameIdentifierType": "LEGL" ,
        "beneficiaryVaspAddressType": "GEOG",
        "beneficiaryVaspTownName": "Seoul",
        "beneficiaryVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "beneficiaryVaspCountry": "KR",
        "beneficiaryVaspNationalIdentifier": "1234567890",
        "beneficiaryVaspNationalIdentifierType": "RAID",
        "beneficiaryVaspRegistrationAuthority": "RA000657"
    }
}
{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "VERIFICATION_TRANSACTION_ID",
    "request": {
        "txid":"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674",
        "vout": "0",
        "transferId": "fafd59e2-aff7-4cff-b7d8-9caa0cda70da",
        
        "amount": "0.00001",
        "tradePrice": "55555",
        "tradeCurrency": "KRW",
        "historicalCost": "",
        "currency": "BTC",
        "originatingVasp": {},
        "isExceedingThreshold": true,

        // originator
        "originatorNaturalPersonLastName": "Barnes",
        "originatorNaturalPersonFirstName": "Robert",
        "originatorNaturalPersonLocalLastName": "반스",
        "originatorNaturalPersonLocalFirstName": "로버트",
        "originatorLegalName": "(주)코인원",
        "originatorLegalPersonLastName": "Kim",
        "originatorLegalPersonFirstName": "Chulsu",
        "originatorLegalPersonLocalLastName": "김",
        "originatorLegalPersonLocalFirstName": "철수",
        "nameIdentifierType": "LEGL",
        "customerIdentification": "originatorCustomerIdentification",
        "originatorWalletAddress": "012345678900",
        // originatingVasp
        "originatingVaspCountryOfRegistration": "KR",
        "originatingVaspLegalName": "Korbit Inc.",
        "originatingVaspNameIdentifierType": "LEGL",
        "originatingVaspAddressType": "GEOG",
        "originatingVaspTownName": "Seoul",
        "originatingVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "originatingVaspCountry": "KR",
        "originatingVaspNationalIdentifier": "1234567890",
        "originatingVaspNationalIdentifierType": "RAID",
        "originatingVaspRegistrationAuthority": "RA000657",

        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryLegalName": "(주)코인원",
        "beneficiaryLegalPersonLastName": "Kim",
        "beneficiaryLegalPersonFirstName": "Minsu",
        "beneficiaryLegalPersonLocalLastName": "김",
        "beneficiaryLegalPersonLocalFirstName": "민수",
        // beneficiaryVasp
        "beneficiaryVaspCountryOfRegistration": "KR",
        "beneficiaryVaspLegalName": "Korbit Inc. beneficiaryVaspLegalName",
        "beneficiaryVaspNameIdentifierType": "LEGL" ,
        "beneficiaryVaspAddressType": "GEOG",
        "beneficiaryVaspTownName": "Seoul",
        "beneficiaryVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "beneficiaryVaspCountry": "KR",
        "beneficiaryVaspNationalIdentifier": "1234567890",
        "beneficiaryVaspNationalIdentifierType": "RAID",
        "beneficiaryVaspRegistrationAuthority": "RA000657"
    }
}

Response

이름필수 여부설명
signature필수생성된 Signature
nonce필수생성된 Nonce
dateTime필수요청의 datetime
publicKey필수요청 하는 VASP의 Public Key
body필수생성된 payload
{
    "signature": "6kfex70cuBgi6yYqRIFmDubuQavgARLjOv2aCmVWBAJ7ENAxumzKtoVNZ/MvoOcYkfkEJd1VTdfDSsG1LFZDCg==",
    "nonce": 1513115728,
    "dateTime": "2024-05-23T05:20:19Z",
    "publicKey": "sG65Uno5V+Vm6XOXuwSuM5XMn+HgpqOZi+8PGaTIAMM=",
    "body": "{\"transferId\":\"fafd59e2-aff7-4cff-b7d8-9caa0cda70da\",\"txid\":\"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674\",\"vout\":\"0\",\"currency\":null,\"amount\":null,\"historicalCost\":null,\"tradePrice\":null,\"tradeCurrency\":null,\"isExceedingThreshold\":false,\"payload\":\"eds32d3TXBkjqokWwrXLuDesLqC8Fxu7G9WoSb2UbnEQ40xzA1K98ue60I5r64voAc8IizoEEVLhhEIt4YB7bci6nW0tb6MU87Zl6b7TXRNUP3Sz6CBWzu5BcrAZ+qswgwmfgCXu3JiZVWyeMq91evmM4jxoNTA//hM4GTEiioiPkSlTSHPmxKTRaVk/ilXqIxsJG0sK3odxu6ylZz9n/xPeS8zRz0QXQXochnywDAC8YwLI0f0MFXkrh/BUvxcTlF9wfETvzSOvRLiGXnGYpzBTXIs/WN+3YzgZ0+JryZLakQo+K0wWIZrm005dBJttLNdxHfWLItAk3f5d6kADe3as3pN2a8rnoRt2gJl4rb5YzRR2tZgHEL9MFJuOWzhCmoprw6ROiRfRk1lnxRyAv8BLPH7PWYpxxB9QXCXCXlTyzBTRpL3QqF7K1oxDshC++7DWHkimTKi3XQNrA8MUG2+b0Ti7aseav58oqtOKmcaRwP8e+VhmIDO3wxF5MzmmpwA1g8Uytpf2MU2W2xm89VODKgktmB9E/5ggTg8Y3lsNBkZKUkwC9ebnMRqGYiA/TKyrr2f2wdf/ezcAa2vJlBsFshd7sGrf/3Zx0vfk8dBUPYpKgfjwXmbRKF6zPrZjgHsLneuJo0QhumdJHX8C4FTyu5S4WjQi12YQaCMoiRgejvs9nJ/zSyGITdpA6YItTYNPa4/1GToaBpcO2O8W+EH7dV16KYonfhxwD+9zrz1WPbyDpsUjvpY1E5+Rt5rtipgNlyTGq1zf5ebzrk67W1d6OmrmjegKnBuVBVKnhcqWhO/zq8Ax5eh2QdOtvL/mWMRm6i41FBtsJAyAeGYMlub5zKVCwZaTDT4sWcfs7RLB2UzSSOfbLZfHLSgW9aVv+DP9mtdQLyyFT1MS/bPC1SUU9fwwLDq0gGM5SdSaKyoYc9gwYnQGTCJPCE84sAqtSM7oTybDtcURRsiumm4UMcFQDQ0aNrZ8FAl7UA87XxvylJAw2TXn6fNclL2pX2HASFHVPjR38lYjz+2TiYNjZH7B/Zz0s0pxZ2ukqWddML9fWs4AajDTNg7IweM7PAWIrS1MUeWc6yPiISm6yt8wIsgMKIasIM4DDT1wH+TdAARKaPCFEezpwCoUmpFWCi4Nb63+hoo0EDZ88xvboxnOZyiYK7GKGsXDMXSdRYLt+rNr8ProZs1Twz0vLqFwbiTmpntIdlSn3UNRpT79zBGRCzagFI2u3mq1n4GodO4DsfIU2ZjAGIB3s6FAiMWsxtJnTNKh26uFDmN9sXT7Kw1iFcZW3P9BhH06JtYHsmEvuwPMsZJKyAx8GueWCTXLa1hervWw+14ojazHgUQ=\"}"
}

Example

Language