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 Type Required idempotentId required amount required destination required memo optional bankAccountId optional
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"
}
Updated 20 days ago