Requested
Fires when a payment operation (deposit, withdrawal, swap) is created.
Authorizations
JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.
Body
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 X-Event-Type header — or currentState.status on the payload — to tell which transition fired.
Your own identifier for the operation, as you sent it on the create request. Free-form: it is not deduplicated, and the same value may appear on more than one operation. null when you sent none, and on a deposit credited from an incoming payment nobody requested.
1 - 255"order-2026-0043"
Reference to the customer that owns the operation.
Reference to a customer account, including the registered owner name.
Monetary amount expressed as a decimal string in the asset's canonical scale. Use a decimal-precision library for arithmetic — never JavaScript Number.
Monetary amount expressed as a decimal string in the asset's canonical scale. Use a decimal-precision library for arithmetic — never JavaScript Number.
What the operation was asked to do. Discriminated by type, and the same discriminator travels as the X-Operation-Intent message attribute so a subscription can filter on it.
- Withdrawal
- Deposit
- Swap
- Transfer
Fee charged on the operation. Discriminated by type.
- Percentage
- Absolute
Underlying rail transactions executed for this operation.
A confirmed rail movement behind the operation. Discriminated by type, which names the rail that moved the money — INTERNAL_DEBIT and INTERNAL_CREDIT are the two legs of a movement that stays inside the platform and touches no external rail.
- PIX
- Crypto
- TED
- Boleto
- Internal debit
- Internal credit
Status the operation is in at the time the event fires.
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.
"2026-04-28T14:32:11Z"
Quote linked to the operation, when applicable. null for same-asset operations or operations without a quote.
System-managed labels stamped onto the operation when it is created. Inherited from the account's propagating tags.
Response
Acknowledged. Trace Finance considers any 2xx response a successful delivery.