Lançamento Futuros Diários

Esta rota lista todas as transações agendadas para liberação futura, exibindo detalhes diários, valores originais, valores líquidos, bandeira do cartão, modalidade, ponto de venda, data prevista de liquidação e outros metadados. É ideal para conciliação detalhada e previsões financeiras de curto prazo.

🔽
GET urlServidor/v1/marketplace/transactions/future_releases_daily

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
`establishment_id`	string	Sim	ID do estabelecimento ao qual os lançamentos estão vinculados.

Exemplo de header da requisição

curl--request GET \
--location '/v1/marketplace/transactions/future\_releases\_daily' \
--header 'integration-key: your_integration_key' \
--header 'x-token: your_x_token' \
--header 'Authorization: Bearer {{bearer_token}}' \
--header 'establishment_id: your_establishment_id' \

📎 Query Parameters

Nome	Tipo	Descrição
`filters`	string	JSON de filtros. Campos filtráveis: `gateway_authorization`, `date`. Exemplo:"gateway_authorization":"PAYTIME","date":"2026-03-30"
`search`	string	Texto de busca livre.
`perPage`	number	Quantidade de registros por página.
`page`	number	Página atual.
`sorters`	string	JSON com lista de ordenadores. Campos ordenáveis: `created_at`, `id`.

✅ Exemplo de Response de sucesso.

{
    "total": 4,
    "page": 1,
    "perPage": 20,
    "lastPage": 1,
    "data": [
        {
            "transaction_date": "2025-06-03T18:35:54.547Z",
            "transaction_modality": "CREDIT 10x",
            "brand_name": "MASTERCARD",
            "gateway_authorization": "PAYTIME",
            "point_of_sale": "ONLINE",
            "transaction_original_amount": 14295,
            "transaction_amount": 14005,
            "transaction_id": "683f408bbb9f32ba3b65",
            "date": "2026-03-30",
            "installment": 10,
            "amount": 1405
        },
        {
            "transaction_date": "2025-06-03T18:51:14.590Z",
            "transaction_modality": "CREDIT 10x",
            "brand_name": "MASTERCARD",
            "gateway_authorization": "PAYTIME",
            "point_of_sale": "ONLINE",
            "transaction_original_amount": 14295,
            "transaction_amount": 14005,
            "transaction_id": "683f4422b=b9f32ba3c28",
            "date": "2026-03-30",
            "installment": 10,
            "amount": 1405
        },
        {
            "transaction_date": "2025-06-03T20:03:48.376Z",
            "transaction_modality": "CREDIT 10x",
            "brand_name": "MASTERCARD",
            "gateway_authorization": "PAYTIME",
            "point_of_sale": "ONLINE",
            "transaction_original_amount": 14295,
            "transaction_amount": 14005,
            "transaction_id": "683f5525bb9f32ba3cec",
            "date": "2026-03-30",
            "installment": 10,
            "amount": 1405
        },
        {
            "transaction_date": "2025-06-03T20:07:20.810Z",
            "transaction_modality": "CREDIT 10x",
            "brand_name": "MASTERCARD",
            "gateway_authorization": "PAYTIME",
            "point_of_sale": "ONLINE",
            "transaction_original_amount": 14295,
            "transaction_amount": 14005,
            "transaction_id": "683f55f9b=b9f32ba3daf",
            "date": "2026-03-30",
            "installment": 10,
            "amount": 1405
        }
    ]
}

📋 Explicação de Atributos da Resposta

Campo	Tipo	Obrigatório	Descrição
`total`	number	Sim	Número total de registros encontrados para os filtros aplicados.
`page`	number	Sim	Página atual da consulta.
`perPage`	number	Sim	Quantidade de registros exibidos por página.
`lastPage`	number	Sim	Número total de páginas disponíveis para os filtros aplicados.
`data`	array	Sim	Lista de itens detalhando cada lançamento futuro diário.
`data[].transaction_date`	string	Sim	Data/hora exata em que a transação foi realizada (em UTC).
`data[].transaction_modality`	string	Sim	Modalidade da transação (ex.: `CREDIT`, `PIX`, `DEBIT`).
`data[].brand_name`	string	Sim	Nome da bandeira do cartão utilizado (ex.: `VISA`, `MASTERCARD`).
`data[].gateway_authorization`	string	Sim	Subadquirente responsável pela autorização da transação. Valores: `PAYTIME`, `ZOOP`, `PAGSEGURO`.
`data[].point_of_sale`	string	Sim	Nome ou identificação do ponto de venda onde a transação foi originada.
`data[].transaction_original_amount`	number	Sim	Valor original da transação, em centavos.
`data[].transaction_amount`	number	Sim	Valor líquido da transação, em centavos (após taxas e reduções).
`data[].transaction_id`	string	Sim	Identificador único da transação.
`data[].date`	string	Sim	Data prevista para a liberação do valor (formato `YYYY-MM-DD`).
`data[].installment`	number	Sim	Número de parcelas, se for transação parcelada (ex.: `1` para pagamento à vista).
`data[].amount`	number	Sim	Valor líquido da parcela, em centavos.

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.