post https://your-server-host.com/api/v1/code/api-payloads
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=\"}"
}