Transaction Ted

TED is Trace's service for interbank transfers (STR/TED) in BRL, offering a fast, secure, and auditable way to send amounts to third-party accounts.


Initiates an interbank transfer in BRL to third-party accounts.

Requires:

  • idempotentId
  • amount.value (cents)
  • destination with CPF/CNPJ, bank, branch, account and account type
  • memo and bankAccountId are optional.

Validates:

  • Key TypeRequired
    idempotentIdrequired
    amountrequired
    destinationrequired
    memooptional
    bankAccountIdoptional

Endpoint

POST /ted/v1/api/transactions; 

State flow:

→ CREATED → (PENDING_SIGNATURES) → PROCESSING → COMPLETED/FAILED,

with events emitted for traceability.


{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "bankAccountId": "550e8400-e29b-41d4-a716-446655440000",
  "companyId": "company_12345",
  "idempotentId": "TXN_20240315_001",
  "amount": {
    "value": 150000,
    "currency": "BRL"
  },
  "states": [
    {
      "status": "CREATED",
      "reason": null,
      "createdAt": "2024-03-15T14:30:00.123Z"
    }
  ],
  "currentState": {
    "status": "CREATED",
    "reason": null,
    "createdAt": "2024-03-15T14:30:00.123Z"
  },
  "operation": "DEBIT",
  "origin": {
    "taxId": "12345678000190",
    "legalName": "ANAKIN SKY WALKER",
    "accountNumber": "12345",
    "accountType": "CHECKING",
    "bankCode": "213",
    "bankName": "BANK ARBI.",
    "branchCode": "0001"
  },
  "destination": {
    "taxId": "98765432109",
    "legalName": "Luke sky walker",
    "accountNumber": "123456",
    "accountType": "CHECKING",
    "bankCode": "001",
    "bankName": "bank name sa",
    "branchCode": "0004"
  },
  "strNumber": null,
  "memo": "lorem ipsum",
  "createdAt": "2024-03-15T14:30:00.123Z",
  "updatedAt": "2024-03-15T14:30:00.123Z"
}