We refreshed our doc site!
Bookmarked links may have changed
Read release notesDue to FinCEN guidance regarding transfers of $3,000 or more, Circle APIs may require you to share information about the originator of the transaction to prevent the transfer from failing. According to FinCEN guidance regarding applicability of the Travel Rule to ERC-20 transfers (including USDC) on Ethereum of $3,000 or more (or matching cryptocurrency), the originating institution must transmit KYC information about the originator of a transaction to the beneficiary institution.
When sending non-business account transfers on the Ethereum or Bitcoin chain of $3,000 in value or more, the originator’s identity will be required. If you are sending a transfer on behalf of your end-user, you need to provide the identity of your end-user. Otherwise, you need to provide your company’s identity.
In technical terms, the originator’s identity is required for POST /v1/transfers
when:
destination.type: "blockchain"
destination.chain: "ETH" or "BTC"
amount.amount
>= $3,000 in valueIf the POST /v1/transfers
request requires an originator's identity and the transfer does not contain an originator's identity, the transfer will fail. You will receive a webhook notification with data.status: fail
, riskEvaluation.decision: denied
, and riskEvaluation.reason: 3220
.
Although first-party transfers must comply with the Travel Rule, you do not need to provide your company’s identity each time you make a business account transfer POST /v1/businessAccount/transfers
. Instead, Circle will use your company’s identity stored on file and provide it to the receiving institution as required.
If yours is a certain type of regulated financial institution, you are subject to additional Travel Rule compliance requirements when receiving transfers. In this case, we will provide you with the originator’s identity for webhook notifications of type transfer in addition to GET /v1/transfers
and GET /v1/transfers/{id}
. However, originator data will not be associated with a transfer until it is marked with a status of complete.
At this time, not all sending institutions are participating in the on-chain Travel Rule requirement. Therefore, not all transfers valued at $3,000 or more will have the originating person associated.
If you are a financial institution and do not see the originator’s identity, please reach out to a Circle representative.
Non-bank financial institutions will not see the originator’s identity for received transfers.
Field | Type | Definition |
---|---|---|
Identities.type [REQUIRED] | String [enum]: individual , business | individual - A uniquely distinguishable individual. business - Any entity other than a natural person that can establish a permanent customer relationship with an affected entity or otherwise own property. This can include companies, foundations, anstalt, partnerships, associations and other relevantly similar entities |
Identities.name [REQUIRED] | String [max length 1024] | Full name of the originator. |
Identities.addresses.line1 [REQUIRED] | String [max length 1024] | Line one of the street address. Note: If the originator is a business, this is the principal place of business address. If the originator is an individual, this is the current residential address. |
identities.addresses.line2 | String [max length 1024] | Line two of the street address. |
Identities.addresses.city [REQUIRED] | String [max length 1024] | City portion of the address. |
identities.addresses.district | String [max length 16] | State / County / Province / Region portion of the address. If the country is US or Canada district is required and should use the two-letter code for the subdivision. |
Identities.addresses.country [REQUIRED] | String [max length 2] | Country portion of the address. Formatted as a two-letter country code specified in ISO 3166-1 alpha-2. |
identities.addresses.postalCode [REQUIRED] | String [max length 16] | Postal / ZIP code of the address. |
{
"idempotencyKey": "ba943ff1-ca16-49b2-ba55-1057e70ca5c7",
"source": {
"type": "wallet",
"id": "12345",
"identities": [
{
"type": "individual",
"name": "Satoshi Nakamoto",
"addresses": [
{
"line1": "100 Money Street",
"line2": "Suite 1",
"city": "Boston",
"district": "MA",
"country": "US",
"postalCode": "01234"
}
]
}
]
},
"destination": {
"type": "blockchain",
"address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
"chain": "ETH"
},
"amount": {
"amount": "3000.00",
"currency": "USD"
}
}
{
"data": [
{
"id": "b36cbf12-6ed1-47ed-9eb9-5874f8991ca8",
"source": {
"type": "wallet",
"id": "12345",
"identities": [
{
"type": "individual",
"name": "Satoshi Nakamoto",
"addresses": [
{
"line1": "100 Money Street",
"line2": "Suite 1",
"city": "Boston",
"district": "MA",
"country": "US",
"postalCode": "01234"
}
]
}
]
},
"destination": {
"type": "blockchain",
"address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
"chain": "ETH"
},
"amount": {
"amount": "3000.00",
"currency": "USD"
},
"transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
"status": "pending",
"createDate": "2020-04-10T02:13:30.000Z"
}
]
}
returnIdentities[boolean]: Specify if you would like to see identities in the response. Restricts maximum returned items to 5. By default returnIdentities is false, resulting in the response not returning data.source.identities
.
{
"data": [
{
"id": "b36cbf12-6ed1-47ed-9eb9-5874f8991ca8",
"source": {
"type": "wallet",
"id": "12345",
"identities": [
{
"type": "individual",
"name": "Satoshi Nakamoto",
"addresses": [
{
"line1": "100 Money Street",
"line2": "Suite 1",
"city": "Boston",
"district": "MA",
"country": "US",
"postalCode": "01234"
}
]
}
]
},
"destination": {
"type": "blockchain",
"address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
"chain": "ETH"
},
"amount": {
"amount": "3000.00",
"currency": "USD"
},
"transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
"status": "pending",
"createDate": "2020-04-10T02:13:30.000Z"
}
]
}
returnIdentities[boolean]: Specify if you would like to see identities in the response. Restricts maximum returned items to 5. By default returnIdentities is false, resulting in the response not returning data.source.identities
.
{
"data": {
"id": "b36cbf12-6ed1-47ed-9eb9-5874f8991ca8",
"source": {
"type": "wallet",
"id": "12345",
"identities": [
{
"type": "individual",
"name": "Satoshi Nakamoto",
"addresses": [
{
"line1": "100 Money Street",
"line2": "Suite 1",
"city": "Boston",
"district": "MA",
"country": "US",
"postalCode": "01234"
}
]
}
]
},
"destination": {
"type": "blockchain",
"address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
"chain": "ETH"
},
"amount": {
"amount": "3000.00",
"currency": "USD"
},
"transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
"status": "pending",
"createDate": "2020-04-10T02:13:30.000Z"
}
}
{
"clientId": "c60d2d5b-203c-45bb-9f6e-93641d40a599",
"notificationType": "transfers",
"transfer": {
"id": "b36cbf12-6ed1-47ed-9eb9-5874f8991ca8",
"source": {
"type": "wallet",
"id": "12345",
"identities": [
{
"type": "individual",
"name": "Satoshi Nakamoto",
"addresses": [
{
"line1": "100 Money Street",
"line2": "Suite 1",
"city": "Boston",
"district": "MA",
"country": "US",
"postalCode": "01234"
}
]
}
]
},
"destination": {
"type": "blockchain",
"address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
"chain": "ETH"
},
"amount": {
"amount": "3000.00",
"currency": "USD"
},
"transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
"status": "pending",
"createDate": "2020-04-10T02:13:30.000Z"
}
}