Skip to main content
WEBHOOK
ACCOUNT_ACTION_REQUIRED
{
  "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
  "customerId": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "owner": {
    "ownerType": "INDIVIDUAL",
    "firstName": "Maria",
    "lastName": "Silva",
    "taxId": {
      "value": "11222333000181",
      "type": "CNPJ",
      "country": "BR"
    },
    "address": {
      "addressLine1": "Rua Augusta, 500",
      "city": "São Paulo",
      "country": "BR",
      "postalCode": "01304-001",
      "addressLine2": null,
      "state": "SP"
    },
    "birthDate": "1990-03-21"
  },
  "atTime": "2023-11-07T05:31:56Z",
  "sourceAccountId": null
}

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 a compliance analysis rejects KYC/KYB data and reverts the account from REVIEWING back to ACTION_REQUIRED. The customer must correct the rejected fields surfaced in requirements.errors before resubmitting for review.

​
id
string<uuid>
required

Account identifier.

Example:

"a1b2c3d4-5e6f-7890-abcd-ef1234567890"

​
customerId
string
required

Identifier of the customer that owns the account.

Example:

"c1a2b3c4-d5e6-7890-abcd-ef1234567890"

​
owner
Individual · object
required

Legal entity that owns the account. Discriminated by ownerType.

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

​
sourceAccountId
string<uuid> | null

Parent account ID for sub-accounts. null for top-level accounts.

Example:

null

Response

200

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