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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
integration-key | string | Sim | Chave de integração. |
x-token | string | Sim | Token de autenticação. Pode ser encontrado em nosso portal na guia de integração. |
Authorization | Auth Type Bearer Token | Sim | Inserir 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
| Campo | Tipo | Descrição |
|---|---|---|
| _id | string | Identificador único do arquivo exportado |
| module | string | Nome do módulo responsável pela exportação |
| name | string | Nome gerado para o arquivo de exportação |
| marketplace_id | string | Identificador do marketplace relacionado à exportação |
| status | string | Status atual do processamento da exportação |
| created_at | string (ISO 8601) | Data de criação da exportação em UTC |
| updated_at | string (ISO 8601) | Data da última atualização da exportação em UTC |
| size | number | Tamanho do arquivo exportado em MB |
| url | string | URL temporária para download do arquivo CSV exportado |
📌 Status da exportação
| Status | Descrição |
|---|---|
| PROCESSING | Arquivo em processamento |
| READY | Arquivo disponível para download |
| ERROR | Erro 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.
Updated 2 months ago
Did this page help you?