Circle is excited to provide an update to how we display the network fees currently charged for transfers on the Ethereum blockchain.

In an effort to provide more real time transparency for blockchain network fees, Circle will now provide the actual network fee charged for a specific transfer shortly after the transaction is complete. This fee will be provided as a USD-equivalent value and these fees will continue to be billed at the end of the month.

We are looking forward to providing your business with this additional layer of visibility and insight at the time of transaction. These fees will start appearing on August 11th, 2022.

There is nothing required of you at this time around this change. We are excited about these enhancements and the improvements they will bring to our valued partnership.

Webhook Notifications

Fees will be sent in the Transfer notification after the Transfer has completed, retaining the status of complete.

📘
Notifications are sent anytime there is a change to the underlying resource.

{
 "clientId": "f1397191-56e6-42fd-be86-0a7b9bd91522",
 "notificationType": "transfers",
 "version": 1,
 "customAttributes": { "clientId": "f1397191-56e6-42fd-be86-0a7b9bd91522" },
 "transfer": {
   "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
   "source": {
     "type": "wallet",
     "id": "01223456789"
   },
   "destination": {
     "type": "blockchain",
     "address": "0x6c78461B9a9AC4EB45C9FfF87a83999c9ad975fD",
     "chain": "ETH"
   },
   "amount": {
     "amount": "3.14",
     "currency": "USD"
   },
   "fees": [
     {
       "amount": "3.14",
       "currency": "USD",
       "type": "network"
     }
   ],
   "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
   "status": "complete",
   "createDate": "2022-05-18T15:44:21.665Z"
 }
}

APIs

Once released, the following endpoints will be updated to include a fees array of type TransferFee once the fees are known.

/v1/businessAccount/transfers
/v1/businessAccount/transfers/:id
/v1/transfers
/v1/transfers/:id

📘
Once these changes have gone into effect, our API References will then include fees.

{
 "data": {
   "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
   "source": {
       "type": "wallet",
       "id": "01223456789"
   },
   "destination": {
       "type": "blockchain",
       "address": "0x6c78461B9a9AC4EB45C9FfF87a83999c9ad975fD",
       "chain": "ETH"
   },
   "amount": {
     "amount": "3.14",
     "currency": "USD"
   },
   "fees": [
     {
       "amount": "3.14",
       "currency": "USD",
       "type": "network"
     }
   ],
   "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
   "status": "complete",
   "createDate": "2022-05-18T15:44:21.665Z"
 }
}

Transfer Fee Schema

Name	Type	Required	Read Only	Description
type	String [Enum]	True	True	Type of fee. Enum values are `network`.
amount	String	True	True	Magnitude of the amount, in units of the currency, with a `.`.
currency	String	True	True	Currency code. Enum values are `USD`.