Skip to main content
WEBHOOK
ACCOUNT_ASSET_FAILED
{
  "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customerId": "<string>",
  "assets": [
    "BRL"
  ],
  "reason": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance for the requested operation",
    "details": {}
  },
  "atTime": "2023-11-07T05:31:56Z"
}

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:
USD,
BRL,
EUR,
CAD,
AUD,
GBP,
MXN,
HKD,
SGD,
PHP,
NZD,
CHF,
NOK,
DKK,
PLN,
SEK,
USDC,
USDT,
EURC,
BRLT
​
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.