---
title: "Detalhar transferência"
method: GET
path: "/v1/marketplace/transfers/{id}"
tags: ["Transferências"]
---

# Detalhar transferência

`GET /v1/marketplace/transfers/{id}`

## Path parameters

- `id` string, required

## Headers

- `integration-key` string, required
- `x-token` string, required

## Response `200`

- TransferResponse
  - `_id` string, required — ID da transferência.
  - `type` 'TED' | 'P2P' | 'PIX', required — Tipo da transferência.
  - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required — Status atual da transferência.
  - `amount` number, required — Valor transferido em centavos.
  - `original_amount` number — Valor original da transferência em centavos.
  - `establishment_id` string, required — ID do estabelecimento.
  - `gateway_key` string — Código do gateway.
  - `gateway_authorization` string, required — Código de autorização do gateway.
  - `expected_at` string, date-time, required — Data prevista para conclusão da transferência.
  - `recipient` TransferAccount, required
    - `establishment` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `marketplace` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `representative` TransferEntity
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `document` string, required — Documento do titular (CPF/CNPJ).
    - `bank_code` string — Código do banco.
    - `bank_ispb` string — ISPB do banco.
    - `bank_name` string — Nome do banco.
    - `routing_number` string — Número da agência bancária.
    - `routing_check_digit` string — Dígito verificador da agência.
    - `account_number` string, required — Número da conta bancária.
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required — Tipo da conta.
    - `pix_key` string — Chave pix de origem ou destino.
  - `payer` TransferAccount, required
    - `establishment` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `marketplace` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `representative` TransferEntity
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `document` string, required — Documento do titular (CPF/CNPJ).
    - `bank_code` string — Código do banco.
    - `bank_ispb` string — ISPB do banco.
    - `bank_name` string — Nome do banco.
    - `routing_number` string — Número da agência bancária.
    - `routing_check_digit` string — Dígito verificador da agência.
    - `account_number` string, required — Número da conta bancária.
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required — Tipo da conta.
    - `pix_key` string — Chave pix de origem ou destino.
  - `history` TransferHistory[], required — Histórico de status da transferência.
    - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required — Status histórico da transferência.
    - `created_at` string, date-time, required — Data do registro do histórico.
    - `_id` string, required
  - `method` 'IN' | 'OUT', required — Direção da transferência (entrada ou saída).
  - `pixKey` string — Chave Pix utilizada (caso aplicável).
  - `end_to_end` string — Identificador único de cada transação.
  - `description` string — Descrição da transferência.
  - `reprocessed` boolean, required — Indica se a transferência foi reprocessada.
  - `created_at` string, date-time, required — Data de criação da transferência.
  - `updated_at` string, date-time, required — Data da última atualização da transferência.
  - `fees` number — Valor total de taxas da transferência.
  - `user` TransferUser
    - `id` number, required — Id do usuário.
    - `first_name` string, required — Primeiro nome.
    - `last_name` string — Sobrenome.
    - `profile_id` number, required — Id do perfil.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)