Listar todas as regras de pré-split

Esta rota permite listar todas as regras de Split Pré configuradas para um estabelecimento.

🔼

GET `urlServidor/v1/marketplace/establishments/establishment_id/split-pre

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

Exemplo de header da requisição

curl--request GET \
--location 'GET /v1/marketplace/establishments/{establishment_id}/split-pre' \
--header 'integration-key: your_integration_key' \
--header 'x-token: your_x_token' \
--header 'Authorization: Bearer {{bearer_token}}' \

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

Parâmetros de Path

NomeTipoObrigatórioDescrição
establishment_idstringSimID do estabelecimento para o qual listar regras

✅ Exemplo de Resposta

{
    "total": 2,
    "perPage": 20,
    "page": 1,
    "lastPage": 1,
    "data": [
        {
            "id": 3,
            "title": "Comissão Sandbox Atualizado",
            "modality": "PIX",
            "channel": "ALL",
            "division": "PERCENTAGE",
            "installment": 2,
            "establishment_id": 415585,
            "active": 1,
            "__meta__": {
                "ecs_count": 3
            }
        },
        {
            "id": 2,
            "title": "Comissão SAndbox",
            "modality": "CREDIT",
            "channel": "ONLINE",
            "division": "PERCENTAGE",
            "installment": 3,
            "establishment_id": 415585,
            "active": 1,
            "__meta__": {
                "ecs_count": 1
            }
        }
    ]
}

📋 Explicação de Atributos da Resposta

NomeTipoObrigatórioDescrição
totalnumberSimNúmero total de registros encontrados para os filtros aplicados.
perPagenumberSimQuantidade de registros retornados por página.
pagenumberSimPágina atual da resposta.
lastPagenumberSimÚltima página disponível com base na paginação.
idnumberSimIdentificador único da regra de Split Pré.
titlestringSimTítulo ou nome descritivo da regra.
modalitystringSimModalidade da transação que a regra se aplica (ALL, CREDIT, DEBIT, PIX).
channelstringSimCanal de venda (ALL, CHIP, TAP, SMART, ONLINE).
divisionstringSimTipo de divisão da regra (PERCENTAGE ou CURRENCY).
installmentnumberNãoNúmero de parcelas. Aplicável quando a modalidade for CREDIT.
establishment_idnumberSimID do estabelecimento principal (criador da regra).
activebooleanSimIndica se a regra está ativa (true) ou inativa (false).
__meta__.ecs_countnumberSimNúmero de estabelecimentos participantes ativos associados à regra.

⚠️ Observações

Uma regra de Split Pré define a divisão automática de valores entre estabelecimentos no momento da criação da transação.

É possível configurar múltiplas regras desde que não sejam conflitantes (ex: mesma modalidade e canal).

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?