Santander

objetivo o conector santander permite a integração com as principais operações financeiras da api do banco santander ele possibilita a execução de pagamentos, consultas e gestão de transações diretamente na fluid api funcionalidades execução de pagamentos permite realizar pagamentos de boletos, pix e transferências bancárias consulta de status verifique o status de transações, boletos e pagamentos efetuados gerenciamento de workspaces organize pagamentos por ambientes de trabalho distintos segurança e autenticação utiliza autenticação baseada em api key e certificados para garantir conexões seguras configuração parâmetros de conexão estes são os parâmetros necessários para configurar a conexão com o banco santander parâmetro descrição nome (obrigatório) identificação única para a conexão descrição (opcional) texto explicativo sobre a conexão id do cliente (obrigatório) identificador único da aplicação no santander chave secreta do cliente (obrigatório) client secret da aplicação certificado público certificado público da aplicação certificado privado certificado privado associado à aplicação escopo escopo de permissões associado à aplicação ambiente (obrigatório) define se a conexão será usada em ambiente de produção ou homologação url do ambiente (obrigatório) endereço base da api do santander módulos disponíveis os módulos representam categorias de funcionalidades dentro do conector santander para cada módulo, há recursos e operações disponíveis 1\ módulo cobrança gerenciamento de boletos e faturas documentação da api de cobranças 🔹 recurso workspaces \[get] listar workspaces → retorna todos os workspaces de cobrança \[get] consultar workspace → obtém detalhes de um workspace específico \[post] criar um workspace → registra um novo workspace de cobranças 🔹 recurso boletos de cobrança \[get] consultar boleto → obtém dados detalhados de um boleto \[get] listar boletos → retorna uma lista de boletos cadastrados \[post] registrar um boleto → cria um novo boleto de cobrança \[patch] atualizar um boleto → permite alterar status e valores de um boleto existente 2\ módulo pagamentos gerenciamento de pagamentos e transações documentação da api de pagamentos 🔹 recurso workspaces \[get] listar workspaces → retorna os workspaces de pagamentos \[get] consultar workspace → obtém dados de um workspace específico \[post] criar um workspace → registra um novo workspace de pagamentos 🔹 recurso código de barras \[get] consultar pagamento por código de barras → obtém status e detalhes de um pagamento via código de barras \[get] listar pagamentos por código de barras → retorna uma lista de pagamentos registrados \[post] iniciar pagamento → efetua um pagamento via código de barras \[patch] confirmar pagamento → atualiza status de um pagamento pendente 🔹 recurso pix payments \[get] consultar pagamento pix → obtém detalhes de um pagamento pix realizado \[post] criar pagamento pix → efetua uma transferência pix via qr code ou chave pix \[patch] confirmar pagamento pix → atualiza status de uma transação pix autenticação a fluid api requer autenticação baseada em api key para acessar o conector santander as credenciais devem ser configuradas corretamente para garantir a segurança das requisições como usar configure sua conexão no painel da fluid api selecione o módulo desejado (cobrança, pagamentos) escolha um recurso e operação compatível com sua necessidade envie os dados conforme os exemplos de payload disponíveis caso de uso fluxo de pagamentos pix com o conector santander visão geral esse fluxo automatiza a jornada completa de um pagamento via pix utilizando o conector santander na plataforma fluid ele cobre desde a listagem de pagamentos pix cadastrados até a efetivação e consulta do status final da transação etapas do fluxo 1️⃣ listagem de pagamentos pix cadastrados o primeiro passo (santander get pix payments) recupera a lista de pagamentos pix existentes dentro do ambiente do usuário isso pode ser útil para verificar transações pendentes ou consultar um pagamento já iniciado anteriormente 2️⃣ iniciação do pagamento pix o usuário escolhe o tipo de pagamento desejado, podendo optar por três variações diferentes dict (diretório de identificadores de contas transacionais) → utiliza uma chave pix para iniciar o pagamento qr code → faz a leitura e pagamento via qr code pix beneficiário → inicia um pagamento informando diretamente os dados bancários do beneficiário dependendo do tipo de pagamento, o fluxo se ramifica para um dos três passos de iniciação santander inicia pix payment dict santander inicia pix payment qrcode santander inicia pix payment beneficiary 3️⃣ consulta do pagamento iniciado após iniciar o pagamento, o passo (santander get pix payment) verifica o status da transação isso garante que os dados do pagamento foram processados corretamente antes de sua efetivação 4️⃣ efetivação do pagamento pix o passo (santander efetiva pix payment) confirma o pagamento iniciado nesta etapa, a transação é oficialmente processada pelo banco 5️⃣ consulta final da transação o passo (santander get pix payment efetivado) verifica se o pagamento foi efetivado com sucesso ou se há alguma pendência essa validação é importante para garantir que o valor foi debitado e recebido corretamente principais benefícios ✅ automação completa o fluxo cobre todas as etapas de um pagamento pix, reduzindo ações manuais ✅ flexibilidade o usuário pode escolher entre diferentes métodos de pagamento (dict, qr code ou beneficiário) ✅ maior segurança a consulta antes da efetivação garante que a transação está correta antes de ser concluída ✅ monitoramento em tempo real o fluxo acompanha o status do pagamento desde a iniciação até a conclusão quando usar esse fluxo? para empresas que realizam pagamentos pix em larga escala e precisam de um processo automatizado para casos em que é necessário validar um pagamento antes da efetivação , reduzindo erros operacionais para integração de sistemas financeiros que exigem acompanhamento detalhado de transações