AntiFraude1

BaixaManual1

CancelaTransacao1

CapturarTransacaoCartao1

ConsultaCartaoTitular1

ConsultaFrancesinha1

ConsultaTransacao2

ConsultaTransacoes2

CriaTokenCartao2

CriaTransacaoBoleto1

CriaTransacaoBoletoCartaoPix1

CriaTransacaoBoletoCartaoPixSplit1

CriaTransacaoBoletoHibrido1

CriaTransacaoBoletoSplit1

CriaTransacaoCartao1

CriaTransacaoCartaoSplit1

CriaTransacaoCartoes1

CriaTransacaoCartoesSplit1

CriaTransacaoCheckout2

CriaTransacaoOpenFinance1

CriaTransacaoPix1

CriaTransacaoPixSimples1

CriaTransacaoPixSimplesSplit1

CriaTransacaoPixSplit1

CriaTransacaoSaldoConta1

Especie313

EstornaTransacaoPIx1

GerarPDF1

Marketplace10

NotaFiscal3

NotaFiscalConfiguracao9

PagueContas3

Protesto5

ProtestoV21

Marketplace

Consulta transações por seller

Changed on Nov 3, 2026

Esta rota permite consultar as transações relacionadas a um seller, desde que possuam split configurado na transação. <br /> Transações sem split não serão retornadas.

Requisição

Campo	Tipo	Descrição	Obrigatório
DataHoraInicial	Data	Data e hora inicial do filtro (formato: YYYY-MM-DDTHH:mm:ss)	Sim
DataHoraFinal	Data	Data e hora final do filtro (formato: YYYY-MM-DDTHH:mm:ss)	Sim
Identificador	Texto	Identificador da transação (filtro opcional)	Não

Resposta

Campo	Tipo	Descrição
Retorno	Texto	Retorno da chamada, podendo possuir os valores OK ou ERRO
DetalhesErro	Texto	Detalhes do erro gerado, caso o retorno seja ERRO
Transacoes	Array[ConsultaTransacaoResponse]	Lista com os dados das transações encontradas

ConsultaTransacaoResponse

Campo	Tipo	Descrição
Identificador	Texto	Identificador da transação
Tipo	Texto	Forma de pagamento
Estado	Texto	Estado da transação
MotivoCancelamento	Texto	Motivo do cancelamento, se houver
DataPagamento	Texto	Data de pagamento da transação
Valor	Numérico	Valor total da transação
ValorPago	Numérico	Valor efetivamente pago
ConfirmadaURL	Booleano	Indica se a transação foi confirmada na URL do comércio
Splits	Array[TransacaoSplit]	Lista de valores divididos por seller ou marketplace
Parcelas	Array[TransacaoParcela]	Informações das parcelas
ClienteDescricao	Texto	Descrição da compra
ClienteIP	Texto	IP do usuário que realizou a transação
ClienteCPFCNPJ	Texto	CPF ou CNPJ do cliente final
ClienteNome	Texto	Nome do cliente final, tamanho máximo de 100 caracteres
NumeroPedido	Texto	Número do pedido ou carrinho, tamanho máximo de 20 caracteres
CardToken	Texto	Token do cartão para transações recorrentes
Recorrente	Booleano	Indica se a transação é recorrente
ContaBolsao	Booleano	Indica se os valores estão alocados em conta bolsão
Referencia	Texto	Referência de localização futura
DataLiquidacao	Texto	Data de liquidação da transação
Liquidado	Booleano	Indica se a transação foi liquidada
EndToEnd	Texto	Código end-to-end da transação

TransacaoSplit

Campo	Tipo	Descrição
ClienteId	Texto	Id do seller ou marketplace
Valor	Numérico	Valor da transação destinado ao Marketplace ou Seller
ValorRoyalties	Numérico	Valor da transação destinado ao Marketplace ou Seller, sobre o qual poderão incidir taxas, conforme a configuração prévia definida para o participante do split
Decisao	Texto	Indica se o split foi criado como auto aprovado

TransacaoParcela

Campo	Tipo	Descrição
Numero	Número	Número identificador da parcela
Estado	Texto	Estado da parcela
MotivoCancelamento	Texto	Motivo do cancelamento da parcela
DataPagamento	Texto	Data/hora de pagamento da parcela
Valor	Numérico	Valor da parcela
ConfirmadaURL	Texto	Indica se foi confirmada na URL do comércio

post/api/marketplace/transacoes

Request

Base URL
https://pagamentos.meuk8.com.br/PagamentosAPI
URL
https://pagamentos.meuk8.com.br/PagamentosAPI/api/marketplace/transacoes
Auth
OAuth 2
Password
Token URL: /BknBankPagamentosAPI/token scopes: BknBankPagamentosAPI

Headers

Aeskeystring required

Request body

DataHoraInicialstring date-time required

DataHoraFinalstring date-time required

Identificadorstring uuid

Example request

{
  "DataHoraInicial": "2026-08-04T10:15:28.6843741-03:00",
  "DataHoraFinal": "2026-08-19T10:15:28.6843741-03:00",
  "Identificador": "942d33fa-ba5a-4a65-b5be-5b47f5033c0a"
}

Response

Criacao da transacao

Retorno'OK' | 'ERRO'

DetalhesErrostring

Example response

{
  "Transacoes": [
    {
      "Splits": [
        {
          "ClienteId": "00000000-0000-0000-0000-000000000000"
        }
      ],
      "CardToken": "00000000-0000-0000-0000-000000000000"
    }
  ]
}

Changes

Nov 3, 2026a8b4ea0aa298 Revision changes
- warning
  added the new Pix enum value to the // response property for the response status (media type: application/json)
- warning
  added the new Pix enum value to the // response property for the response status (media type: text/json)
- warning
  added the new Pix enum value to the // response property for the response status (media type: application/xml)
- warning
  added the new Pix enum value to the // response property for the response status (media type: text/xml)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: text/json)
- info
  added the optional property /// to the response with the status (media type: application/xml)
- info
  added the optional property /// to the response with the status (media type: text/xml)
- info
  added the optional property // to the response with the status (media type: application/json)
- info
  added the optional property // to the response with the status (media type: text/json)
- info
  added the optional property // to the response with the status (media type: application/xml)
- info
  added the optional property // to the response with the status (media type: text/xml)

Operation history