Export - Exportar transações

Permite realizar a exportação imediata de transações em formato CSV. Diferente do fluxo de exportações assíncronas (listar/exportações), essa rota retorna o arquivo diretamente na resposta, sendo indicada para cenários de consulta rápida e baixo volume de dados.


🔽

GET urlServidor/v1/marketplace/transactions/export

Obs: A palavra urlServidor deve ser substituída pela url do servidor.

Parâmetros da Requisição

Headers

NomeTipoObrigatórioDescrição
integration-keystringSimChave de integração.
x-tokenstringSimToken de autenticação. Pode ser encontrado em nosso portal na guia de integração.
AuthorizationAuth Type Bearer TokenSimInserir o Bearer Token, gerado na rota Auth

Exemplo de header da requisição

curl --request GET \
  --location 'urlServidor/v1/marketplace/transactions/export' \
  --header 'integration-key: your_integration_key' \
  --header 'x-token: your_x_token' \
  --header 'Authorization: Bearer {{bearer_token}}'
	--header 'accept: text/csv' \

📤 Resposta

{
    "_id": "6a04b3ae8af35b6d54b8be1e",
    "module": "Transações do Gestor",
    "name": "transacoes-gestor - 1778693038821",
    "marketplace_id": "26",
    "status": "READY",
    "created_at": "2026-05-13T17:23:58.822Z",
    "updated_at": "2026-05-13T17:23:58.822Z",
    "size": 1.561,
    "url": "https://catatau-paytime.s3.sa-east-1.amazonaws.com/exports/marketplace/3b0610cf-c20b-4110-a95d-84a3e49a51e2.csv"
}

Obs: Em sandbox os dados são mocados, representando a estrutura do arquivo e não os dados transacionados pela credenciadora.

Campos da resposta

CampoTipoDescrição
_idstringIdentificador único do arquivo exportado
modulestringNome do módulo responsável pela exportação
namestringNome gerado para o arquivo de exportação
marketplace_idstringIdentificador do marketplace relacionado à exportação
statusstringStatus atual do processamento da exportação
created_atstring (ISO 8601)Data de criação da exportação em UTC
updated_atstring (ISO 8601)Data da última atualização da exportação em UTC
sizenumberTamanho do arquivo exportado em MB
urlstringURL temporária para download do arquivo CSV exportado

📌 Status da exportação

StatusDescrição
PROCESSINGArquivo em processamento
READYArquivo disponível para download
ERRORErro na geração do arquivo

Códigos de Resposta

Consulte a página com os status: Status de respostas

Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a documentação oficial da Paytime.


Did this page help you?