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 that failed onboarding in this event.

ISO 4217 currency code or stablecoin ticker.

Available options:
BRL,
USDT,
USDC
​
reason
object
required

Machine- and human-readable explanation. Populated on an OperationState when the status transition requires justification (e.g., FAILED).

​
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.

Response

200

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