Skip to main content
WEBHOOK

Authorizations

​
Authorization
string
header
required

JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.

Body

application/json

Payload delivered when an account asset's onboarding fails permanently. The asset cannot be used and the account must be re-onboarded with corrected data.

​
accountId
string<uuid>
required
​
customerId
string
required
​
assets
enum<string>[]
required

Assets this event reports on — activated on ACCOUNT_ASSET_ACTIVATED, failed on ACCOUNT_ASSET_FAILED.

ISO 4217 currency code or stablecoin ticker.

Available options:
BRL,
USDT,
USDC
​
atTime
string<date-time>
required

When this event occurred. Distinct from the resource's createdAt — events fire on state transitions, so atTime reflects when the transition happened, not when the underlying resource was first created.

Example:

"2026-04-28T14:32:11Z"

​
reason
object
required

Machine- and human-readable explanation, shared by every state object in this API. Populated when the status transition requires justification (FAILED, ACTION_REQUIRED); null on statuses that need none.

Response

200

Acknowledged. Trace Finance considers any 2xx response a successful delivery.