Documentação de API's Pinbank
Início
Primeiros Passos
Primeiros Passos
  • Guia
  • Obtendo suas Credenciais
  • Gerando o Access Token
  • Autorizando as Requisições
  • Consumindo uma API
Gateway de Pagamentos
Gateway de Pagamentos
  • Introdução
  • Cartão
  • Boleto
  • Pix
Início
Primeiros Passos
Primeiros Passos
  • Guia
  • Obtendo suas Credenciais
  • Gerando o Access Token
  • Autorizando as Requisições
  • Consumindo uma API
Gateway de Pagamentos
Gateway de Pagamentos
  • Introdução
  • Cartão
  • Boleto
  • Pix
Pinbank
LinkedIn
Instagram
Youtube
  1. Cartão
  • Bem-vindo à documentação de APIs da Pinbank!
    • Primeiros passos
    • 1 - Obtendo suas credenciais
    • 2 - Gerando o token de acesso
    • 3 - Autorizando as requisições
    • 4 - Consumindo uma API
  • Autenticação e segurança
  • Gateway de pagamentos
    • Cartão
    • Boleto
    • Pix
    • Pix automático
    • Link de pagamento
  • Banking as a Service - BaaS (Gestão de contas)
    • Onboarding e KYC
    • Gestão de saldo e extrato
    • Pagamentos e transferências
    • Cartão pré-pago
  • Pix (Cash-out)
    • Pagamentos e transferências
    • Pagamentos com Pix automático
  • Webhooks
    • Introdução
    • Configurando o webhook
    • Estrutura da entrega (envelope)
    • Autenticidade da mensagem
    • Política de Reenvio
    • Eventos
  • Especificações técnicas
    • Autenticação
      • Gerar token de acesso
    • Cartão
      • Processar pagamento avulso (Dados diretos)
        POST
      • Cancelar transação
        POST
      • Gerar extrato consolidado de vendas (POS/e-commerce)
        POST
      • Processar pagamento com split de valores
        POST
      • Cancelar transação com split de valores
        POST
      • Processar pagamento com cartão tokenizado salvo
        POST
      • Cadastrar cartão (tokenizado) para compras futuras
        POST
      • Remover cartão tokenizado
        POST
      • Recuperar dados sensíveis do cartão
        POST
      • Listar cartões tokenizados do cliente
        POST
      • Processar pagamento recorrente com split
        POST
      • Confirmar ativação de cartão (PIN/Protocolo)
        POST
    • Boleto
      • RegistrarBoletoDda
      • Gerar boleto de cobrança
      • Emitir boleto com split de valores
      • Consultar o status de um boleto
      • Consultar boletos em lote
      • Obter métricas e indicadores de cobrança
      • Cancelar cobrança via boleto
    • Link de pagamento
      • Gerar um link de pagamento
    • Conta digital
      • Recuperar termos de uso para aceite formal
      • Iniciar onboarding de Mini EC
      • Iniciar onboarding de cliente (PF)
      • Iniciar onboarding de empresa (PJ)
      • Consultar dados da conta
      • Listar novos clientes ativados por período
      • Fazer upload de documentos de identificação
      • Verificar inventário e pendências de documentos
      • Substituir documento reprovado ou expirado
      • Consultar status dos documentos
      • Gerar boleto de recarga de conta
      • Consultar saldo disponível na conta
      • Consultar extrato da conta
      • Consultar comprovante detalhado de transação
    • Cartão pré-pago
      • Solicitar emissão de cartão pré-pago
      • Confirmar ativação de cartão pré-pago
      • Consultar limite do cartão pré-pago
      • Ajustar limite do cartão pré-pago
      • Listar cartões pré-pagos do cliente
      • Listar transações do cartão pré-pago
      • Bloquear uso do cartão pré-pago
      • Solicitar cartão pré-pago virtual
      • Redefinir senha do cartão pré-pago
      • Atualizar senha do cartão pré-pago
      • Gerenciar trava de compras online (E-commerce)
    • Pix
      • Cash-in
        • Gerar QR Code dinâmico para venda única
        • Solicitar estorno parcial ou integral de um Pix
        • Verificar status do estorno de um Pix (Assíncrono)
        • Gerar QR Code dinâmico ou composto com recorrência
        • Consultar status e dados de um QR Code dinâmico
        • Invalidar QR Code dinâmico de cobrança Pix pendente
        • Decodificar QR Code ou Chave Pix
      • Cash-out
        • Confirmar liquidação de um Pix
        • Consultar Pix por lote ou identificador
        • Cadastrar agendamento de um Pix
        • Cadastrar novo favorecido para Pix
        • Consultar a lista de favorecidos para Pix
        • Remover favorecido para Pix
      • Pix automático (Cash-in)
        • Propor adesão ao Pix Automático (Push)
        • Listar contratos de Pix Automático
        • Lançar parcela de Pix Automático
        • Consultar um contrato de Pix Automático
        • Cancelar um agendamento de pagamento de parcela do Pix Automático
        • Cancelar um contrato de Pix Automático
        • Projetar data do próximo débito recorrente
        • Calcular último pagamento
      • Pix automático (Cash-out)
        • Cadastrar recorrência via QR Code
        • Atualizar status de uma recorrência
        • Listar recorrências cadastradas e/ou canceladas
        • Consultar dados de uma recorrência
        • Editar uma recorrência cadastrada
        • Cancelar uma recorrência cadastrada
        • Listar pagamentos agendados, pagos ou cancelados
        • Consultar um agendamento
        • Cancelar um agendamento de pagamento da recorrência
    • Pagamentos e transferências (TED)
      • Transferir saldo internamente (P2P)
      • Solicitar retirada de fundos via TED
      • Rastrear liquidação ou devolução de TED
      • Registrar TED para aprovação posterior
      • Listar TEDs por status ou referência
      • Cancelar TED
      • Autorizar TED pré-cadastrada
      • Validar linha digitável de boleto (CIP)
      • Liquidar boleto ou conta de consumo
      • Liquidar impostos e taxas governamentais
      • Listar pagamentos agendados
      • Cadastrar novo favorecido para TED
      • Consultar a lista de favorecidos para TED
      • Remover favorecido para TED
    • Webhooks
      • Notificação de recebimento Pix
  1. Cartão

Gerar extrato consolidado de vendas (POS/e-commerce)

POST
/api/ContaDigital/ExtratoPos
ContaDigital

Funcionalidade principal#

Este endpoint é a principal ferramenta para fins de conciliação e gestão, fornecendo um relatório consolidado de todas as transações de pagamento processadas por um Canal, abrangendo tanto vendas em ponto de venda (POS) quanto em e-commerce.
A principal característica deste endpoint é a sua poderosa capacidade de filtragem, permitindo extrair dados precisos para análise. Utilize os parâmetros no corpo da requisição para refinar sua busca por:
Período: Através dos campos DataInicial e DataFinal.
Status: Filtrando por transações Aprovadas, Negadas, etc.
Meio de captura: Separando as vendas de POS e E-commerce.

Casos de uso comuns#

1.
Realizar a conciliação financeira diária, semanal ou mensal das vendas.
2.
Gerar extratos detalhados para análise de desempenho.
3.
Investigar um lote de transações que ocorreram em um terminal POS específico, utilizando o IdTerminalPos.
Nota de performance: Para garantir uma resposta rápida e evitar timeouts, é altamente recomendado sempre utilizar um intervalo de datas (DataInicial e DataFinal) o mais específico possível. Consultar períodos muito longos sem filtros pode impactar a performance.

Requisição

Authorization
Adicionar o parâmetro
Authorization
a Cabeçalhos, cujo valor é concatenar o Token após o Bearer.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200Correto
application/json
OK
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/api/ContaDigital/ExtratoPos' \
--header 'UserName;' \
--header 'RequestOrigin;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Data": {
        "CodigoCanal": 0,
        "CodigoCliente": 0,
        "DataInicial": "2025-09-29T19:21:05.936Z",
        "DataFinal": "2025-09-29T19:21:05.936Z",
        "Status": "Todos",
        "MeioCaptura": "Todos",
        "IdTerminalPos": "string",
        "QuantidadeLinhasRetorno": 0
    }
}'
Response Response Example
Response
{
    "Data": [
        {
            "IdTerminal": "string",
            "SerialNumber": "string",
            "Terminal": "string",
            "Bandeira": "string",
            "TipoCompra": "string",
            "DadosExtra": "string",
            "CpfCnpjComprador": "string",
            "NomeRazaoSocialComprador": "string",
            "NumeroParcela": 0,
            "NumeroTotalParcelas": 0,
            "DataTransacao": "2025-09-29T19:21:05.988Z",
            "DataFuturaPagamento": "2025-09-29T19:21:05.988Z",
            "CodAutorizAdquirente": "string",
            "NsuOperacao": 0,
            "NsuOperacaoLoja": "string",
            "ValorBruto": 0,
            "ValorBrutoParcela": 0,
            "ValorLiquidoRepasse": 0,
            "ValorSplit": 0,
            "IdStatus": "string",
            "DescricaoStatus": "string",
            "IdStatusPagamento": "string",
            "DescricaoStatusPagamento": "string",
            "ValorTaxaAdm": 0,
            "ValorTaxaMes": 0,
            "NumeroCartao": "string",
            "DataCancelamento": "2025-09-29T19:21:05.988Z",
            "Submerchant": {
                "Cnpj": "string",
                "Nome": "string",
                "Mcc": "string",
                "EnderecoRua": "string",
                "EnderecoNumero": "string",
                "EnderecoComplemento": "string",
                "EnderecoBairro": "string",
                "EnderecoCidade": "string",
                "EnderecoEstado": "string",
                "EnderecoCep": "string",
                "EnderecoCodIbge": "string",
                "ResponsavelNome": "string",
                "ResponsavelTelefone": "string",
                "ResponsavelEmail": "string"
            },
            "CpfAgComercial": "string",
            "NomeAgComercial": "string"
        }
    ],
    "ResultCode": 0,
    "Message": "string",
    "ValidationData": {
        "ResultCode": 0,
        "Message": "string",
        "Errors": [
            {
                "ErrorMessage": "string",
                "FieldName": "string"
            }
        ]
    }
}
Modificado em 2026-03-03 14:52:50
Página anterior
Cancelar transação
Próxima página
Processar pagamento com split de valores
Built with