API Extrato de Conta Corrente Sicredi

O que é esta API

A API de Extrato de Conta Corrente do Sicredi disponibiliza, em tempo real, as movimentações da conta corrente do associado, para integração com ERPs ou sistemas próprios via requisições REST. A consulta retorna os movimentos do período informado, o saldo anterior ao período e o saldo resultante após cada movimento. A autenticação combina mTLS e OAuth2 (client_credentials), no mesmo servidor de autenticação da família Multipag, e o escopo utilizado é contacorrente.extratos.consultar.

Casos de uso principais:

• Conciliação financeira a partir do extrato de conta corrente
• Integração do extrato a ERPs e sistemas de gestão
• Consulta de movimentações da conta por período

Antes de começar

O acesso envolve o cadastro no Portal do Desenvolvedor, a emissão de um certificado digital e a liberação das credenciais OAuth2.

Como funciona a adesão:

A liberação do acesso segue as etapas abaixo. Algumas dependem de uma ação sua, outras são conduzidas pelo Sicredi.

Ambientes disponíveis:

Passo a passo: sua primeira chamada

1. Obter token de acesso

A API usa OAuth2 Client Credentials sobre mTLS. As credenciais vão no corpo da requisição:

curl --location 'https://mtls-api-parceiro.sicredi.com.br/sb/thirdparty/auth/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'client_id=SEU_CLIENT_ID' \
  --data-urlencode 'client_secret=SEU_CLIENT_SECRET' \
  --data-urlencode 'scope=contacorrente.extratos.consultar'

A chamada exige o certificado mTLS configurado na conexão. O token retornado é do tipo Bearer, com validade de 60 minutos, e deve ser enviado no header Authorization das chamadas seguintes. Quando expirar, requisite um novo token com as mesmas credenciais.

Se você já integra a API Multipag Pagamentos, inclua contacorrente.extratos.consultar junto aos escopos que já utiliza.

2. Consultar o extrato

Consulte as movimentações de um período em /contacorrente/v1/extratos. Os parâmetros vão na query string:

curl --location \
  'https://mtls-api-parceiro.sicredi.com.br/sb/contacorrente/v1/extratos?dataInicio=2026-05-20&dataFim=2026-06-30&page=0&size=10' \
  --header 'Authorization: Bearer SEU_ACCESS_TOKEN'

Parâmetros (query):

• dataInicio (yyyy-mm-dd, obrigatório): deve ser menor ou igual a dataFim
• dataFim (yyyy-mm-dd, obrigatório): deve ser maior ou igual a dataInicio
• page (inteiro): número da página solicitada
• size (inteiro): tamanho da página solicitada

Escopo exigido: contacorrente.extratos.consultar.

Resposta esperada (200 OK):

{
  "saldoAnterior": -500.0,
  "dtlMovimentos": [
    {
      "data": "2026-02-02",
      "descricao": "CHEQUE ESPECIAL INAD-IOF",
      "complemento": null,
      "documento": null,
      "valor": -1.27,
      "saldo": -501.27,
      "codigoLancamento": "262",
      "idMovimento": "20260202-3500410-1-1"
    }
  ],
  "quantidade": 1,
  "totalElements": 1,
  "totalPages": 1,
  "pageNumber": 0,
  "pageSize": 30
}

Cada item de dtlMovimentos traz a data, a descrição, o valor do lançamento e o saldo resultante após o movimento. O saldoAnterior é o saldo da conta antes do primeiro movimento do período. Os campos de paginação (totalElements, totalPages, pageNumber, pageSize) apoiam a leitura de extratos longos.

3. Tratamento de erros

Próximos passos

Precisa de ajuda?

• Portal do desenvolvedor: developer.sicredi.com.br - abertura de chamados via menu Suporte.
• Cooperativa: para questões comerciais e de contratação, procure sua cooperativa Sicredi.