Processing

{ "type": "OPERATION_PROCESSING", "resource": "OPERATION", "customerId": "11111111-1111-1111-1111-111111111111", "timestamp": "2026-11-10T14:32:11Z", "data": { "externalId": "order-2026-0043", "customer": { "id": "9c7b6a2e-1d3f-4a5b-8c9d-0e1f2a3b4c5d" }, "account": { "owner": "Acme Importação Ltda" }, "sourceAmount": { "value": "500.00", "asset": "BRL", "decimals": 2 }, "destinationAmount": { "value": "500.00", "asset": "BRL", "decimals": 2 }, "intent": { "type": "WITHDRAW", "beneficiary": { "entity": { "type": "INDIVIDUAL", "firstName": "John", "lastName": "Doe", "identificationDocument": { "type": "CPF", "value": "52998224725", "country": "BR" }, "birthDate": "1990-01-15", "address": { "addressLine1": "Rua Augusta, 500", "city": "São Paulo", "country": "BR", "postalCode": "01304-001", "addressLine2": null, "state": "SP" } }, "instruction": { "address": { "type": "PixKey", "rail": "PIX_KEY", "keyType": "CPF", "key": "12345678901" } } } }, "fees": [ { "type": "PERCENTAGE", "amount": { "value": "500.00", "asset": "BRL", "decimals": 2 }, "source": "PLATFORM", "percentage": "0.0050" } ], "transactions": [ { "type": "PIX", "direction": "DEBIT", "amount": { "value": "500.00", "asset": "BRL", "decimals": 2 }, "currentState": { "status": "CONFIRMED", "createdAt": "2023-11-07T05:31:56Z", "reason": { "code": "INSUFFICIENT_BALANCE", "message": "Insufficient balance for the requested operation", "details": {} } }, "endToEnd": "<string>" } ], "currentState": { "status": "COMPLETED", "createdAt": "2023-11-07T05:31:56Z", "reason": { "code": "INSUFFICIENT_BALANCE", "message": "Insufficient balance for the requested operation", "details": {} } }, "atTime": "2026-04-28T14:32:11Z", "quote": { "effectiveRate": { "value": "5.4321", "base": "BRL", "quote": "BRL" } }, "tags": [ { "key": "psp", "value": "Amazon" }, { "key": "compliance-tier", "value": "high" } ] } }

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

Body of every webhook delivery. The event metadata sits at the top level and the event object in data. The body is identical on every retry and replay of the same event, and it is the exact content covered by the Webhook-Signature header.

type

enum<string>

required

The specific event type within a resource, sent as the type field of each delivery body.

Available options:

OPERATION_PROCESSING

Example:

"OPERATION_PROCESSING"

resource

enum<string>

required

The resource group an event belongs to, sent as the resource field of each delivery body.

Available options:

OPERATION

Example:

"OPERATION"

customerId

string

required

Identifier of the customer the event belongs to.

Example:

"11111111-1111-1111-1111-111111111111"

timestamp

string<date-time>

required

When the event happened, in ISO 8601 UTC. Fixed for the event: retries and replays carry the same value. The time of each delivery attempt is the Webhook-Timestamp header.

Example:

"2026-11-10T14:32:11Z"

data

object

required

Payload delivered for every operation lifecycle event — OPERATION_REQUESTED, OPERATION_PROCESSING, OPERATION_ACTION_REQUIRED, OPERATION_COMPLETED, OPERATION_FAILED, OPERATION_REFUNDING and OPERATION_REFUNDED. The seven carry the same shape; inspect the body's type field — or currentState.status in data — to tell which transition fired.

Show child attributes

Response

200

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

Accounts

Operations

Reports

Quotes

Beneficiaries

Webhooks

Authorizations

Body

Response