Smart Transfer events

This page covers all Smart Transfer events that can trigger webhook notifications, and their associated data objects for the Webhooks v2 service.

Event types

To receive a specific event, include its eventType in the webhook's notification object.

Event typeData object returned
ticket.createdTicket created
ticket.counterparty.addedTicket counterparty added
ticket.counterparty_external_id.setTicket counterparty external ID set
ticket.note.addedTicket note added
ticket.submittedTicket submitted
ticket.expires_at.setTicket expires at set
ticket.expires_in.setTicket expires in set
ticket.expiredTicket expired
ticket.fulfilledTicket fulfilled
ticket.canceledTicket canceled
ticket.term.addedTicket term added
ticket.term.updatedTicket term updated
ticket.term.deletedTicket term deleted
ticket.term.fundedTicket term funded
ticket.term.manually_fundedTicket term manually funded
ticket.term.funding_canceledTicket term funding canceled
ticket.term.funding_failedTicket term funding failed
ticket.term.funding_completedTicket term funding completed
ticket.term.status_transaction_changedTicket term transaction status changed

Data objects

Ticket created

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
typestringThe type of settlement for the ticket: Currently, only async
statusstringThe status of the ticket
createdByNetworkIdstringThe network ID of the Fireblocks Network profile that created the ticket
createdByNetworkIdNamestringThe name of the Fireblocks Network profile that created the ticket
createdAtdateTime and date when the ticket was created
expiresInnumberExpiration of the ticket in hours

Ticket counterparty added

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
networkIdstringNetwork ID of the connection receiving a ticket
networkIdNamestringName of the Fireblocks Network profile receiving the ticket

Ticket counterparty external ID set

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
externalRefIdstringAny ID a customer adds to the system

Ticket note added

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
bodystringText of the note
createdAtdateTime and date when the note was created

Ticket submitted

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
expiresInnumberExpiration of the ticket in hours
statusstringStatus of the ticket
expiresAtdateDate and time when the ticket expires
submittedAtdateDate and time the ticket is submitted

Ticket expires at set

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
expiresAtdateDate and time when the ticket expires

Ticket expires in set

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
expiresInnumberExpiration of the ticket in hours

Ticket expired

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
statusstringStatus of the ticket
expiresAtdateDate and time when the ticket expired

Ticket fulfilled

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
fulfilledAtdateDate and time when the ticket was fulfilled by both sides

Ticket canceled

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
canceledAtdateDate and time when the ticket was canceled

Ticket term added

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
assetstringAsset name being sent in the term
amountstringAmount of the asset being sent
fromNetworkIdstringNetworkId from which the asset is being sent
toNetworkIdstringNetworkId to which the asset is being sent
statusstringStatus of the ticket

Ticket term updated

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
assetstringAsset name being sent in the term
amountstringAmount of the asset being sent
fromNetworkIdstringNetworkId from which the asset is being sent
toNetworkIdstringNetworkId to which the asset is being sent

Ticket term deleted

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term

Ticket term funded

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
assetstringAsset name of the asset being sent to fund the term
amountstringAmount of the asset being sent to fund the term
networkConnectionIdstringNetwork ID funding the term
srcIdstringvaultId if srcType is VAULT_ACCOUNT;
exchangeId if srcType is EXCHANGE; or
fiatAccountId if srcType is FIAT_ACCOUNT
srcTypestringType of the account from which the funds are originating;
can be a vault, an exchange, or a fiat account
notestringText of the note
feestringAmount of fee paid for the transaction funding the term
feeLevelstringFee level being paid

Ticket term manually funded

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
txHashstringTX hash of the transaction funding the term

Ticket term funding canceled

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
txStatusstringStatus of the transfer funding the term

Ticket term funding failed

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
txStatusstringStatus of the transfer funding the term

Ticket term funding completed

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
txSHashstringTX hash of the transaction funding the term
txStatusstringStatus of the transfer funding the term

Ticket term transaction status changed

ParameterTypeDescription
ticketIdstringUnique ID for the ticket
termIdstringUnique ID of the term
txStatusstringStatus of the transfer funding the term