Obter uma Transferência
Use este endpoint para recuperar o status atual e os detalhes de uma transferência, incluindo seu tipo, histórico de status, detalhes do remetente e destinatário, valores e timestamps. Retorna apenas transferências pertencentes à mesma organização.
Autorizações
Autenticação por token JWT Bearer. O tenantId é derivado do token bearer ou do contexto de requisição autenticado e não é fornecido por meio do X-Organization-Id.
Cabeçalhos
Escopo da organização Midaz para a requisição, usado para chamadas downstream ao CRM, Fees e Midaz. Obrigatório nas rotas de transferência com escopo de organização em todos os modos de implantação; um valor ausente ou que não seja UUID retorna 400. Este não é o identificador do tenant — o tenantId é derivado do JWT bearer ou do contexto autenticado, nunca deste cabeçalho. Workers em segundo plano (poller de TED IN, conciliação) não possuem cabeçalho de requisição e, no modo single-tenant, recorrem à variável de ambiente ORGANIZATION_ID da implantação.
Parâmetros de caminho
O identificador único da transferência.
Resposta
Indica que a transferência foi encontrada e seus detalhes são retornados.
O identificador único da transferência.
"019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d"
O tipo de transferência. TED_OUT é uma transferência de saída para um banco externo via JD SPB. TED_IN é uma transferência de entrada de um banco externo. P2P é uma transferência ponto a ponto dentro da mesma instituição (mesmo ISPB).
TED_OUT, TED_IN, P2P "TED_OUT"
O status atual da transferência. Para TED OUT: CREATED → PENDING → PROCESSING → COMPLETED, REJECTED ou FAILED. Para P2P: CREATED → PROCESSING → COMPLETED ou FAILED (PENDING é um estado específico do SPB e não se aplica a P2P). Transferências podem ser canceladas (CANCELLED) enquanto estiverem com status CREATED ou PENDING. Para TED IN: RECEIVED → PROCESSING → COMPLETED ou FAILED. Um TED IN em status COMPLETED também pode transitar para FAILED em caso de estorno.
CREATED, PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, CANCELLED, RECEIVED "COMPLETED"
UUID da conta do remetente. Sempre presente. Para TED IN, onde o remetente é um banco externo sem conta local, este é um identificador sintético derivado de forma determinística a partir do documento do remetente.
"019c96a0-0c0c-7221-8cf3-13313fb60081"
O valor da transferência sem a tarifa.
1000.5
A tarifa cobrada por esta transferência.
1.5
O valor total, calculado como o valor da transferência mais a tarifa.
1002
O timestamp de quando a transferência foi criada.
"2026-02-01T15:30:00-03:00"
O timestamp da última atualização de status.
"2026-02-01T15:35:00-03:00"
O histórico de transições de status desta transferência.
Para devoluções TED IN, o ID da transferência de entrada original que está sendo devolvida.
"019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d"
Código BACEN do motivo da devolução, presente apenas quando a transferência é uma devolução.
"18"
UUID da conta do destinatário, quando o destinatário é representado como uma conta Midaz.
"019c96a0-ac10-7efa-b1c2-2a3b4c5d6e7f"
O código de confirmação legível, se disponível.
20"20260201001"
O número de controle do JD SPB, presente para transferências TED OUT e TED IN.
20"202602010001"
O ID da transação correspondente no ledger Midaz.
"019c96a0-ac10-7efa-b1c2-2a3b4c5d6e7f"
A finalidade ou descrição da transferência.
140"Payment for services"
Metadados personalizados como pares chave-valor.
O timestamp de quando a transferência foi concluída. Nulo se ainda não concluída.
"2026-02-01T15:35:00-03:00"

