Documentação da API Validação Dados Bancários

Validar dados bancários

Método para validar dados bancários através do código do banco, agência, dígito da agência, conta e dígito da conta.

GET

URL para requisição

https://www.sintegraws.com.br/api/v1/execute-api.php?token={token}&cod_banco={cod_banco}&agencia={agencia}&agencia_dv={agencia_dv}&conta={conta}&conta_dv={conta_dv}&plugin={BANK}

Parâmetros de requisição da API do Validação Dados Bancários

token
string

obrigatório
O seu token é gerado após o cadastro no portal.
Ver meu token

cod_banco
string

obrigatório
Código do banco que deseja validar.

agencia
string

obrigatório
Número da agência bancária.

agencia_dv
string

obrigatório
Dígito da agência bancária. Caso a agência não possua dígito, envie vazio.

conta
string

obrigatório
Número da conta bancária.

conta_dv
string

obrigatório
Dígito da conta bancária.

plugin
string

obrigatório
Site no qual deseja as informações, no caso da API Validação Dados Bancários informar "BANK".

Exemplo de resposta da API Validação Dados Bancários
Uma resposta típica é composta por um JSON.

  • Status: 200 OK
  • Time: 200 ms
  • Size: 2021 bytes
{"status":"OK","code":"0","cod_banco":"341","agencia":"0355","agencia_dv":"","conta":"04580","conta_dv":"8","valido":true,"info_agencia_bancaria":{"cnpj":"60701190069210","nome_instituicao":"Ita\u00fa unibanco s.a.","segmento":"Banco m\u00faltiplo","numero_agencia":"0355","nome_agencia":"S.paulo\/volunt.da patria","endereco":"Rua voluntarios da patria - 1780","numero":"","complemento":"","bairro":"Santana","cep":"02010500","municipio":"Sao paulo","uf":"SP","data_inicio":"21\/10\/1975","ddd":"11","telefone":"30034828","id_instalacao":"9999969821"}}                  

Campos de retorno da API Validação Dados Bancários

status string
Indica a situação da requisição.
Valores possíveis:
  • OK
  • ERROR
code string
Código de retorno utilizado para informar o status da requisição.
cod_banco string
Código do banco.
agencia string
Número da agência bancária.
agencia_dv string
Dígito da agência bancária.
conta string
Número da conta bancária.
conta_dv string
Dígito da conta bancária.
valido boolean
Informa se os dados bancários são válidos.
Valores possíveis:
  • true
  • false
erros Array [objeto]
Em caso de erro, uma lista de erros é apresentada.

erros.code string
Código do erro.
erros.description string
Descrição do erro.
info_agencia_bancaria objeto
Detalhes da agência bancária.

info_agencia_bancaria.cnpj string
Número do CNPJ da instituição bancária.
info_agencia_bancaria.nome_instituicao string
Nome da instituição bancária.
info_agencia_bancaria.segmento string
Segmento da instituição bancária.
info_agencia_bancaria.numero_agencia string
Número da agência bancária.
info_agencia_bancaria.nome_agencia string
Nome da agência bancária.
info_agencia_bancaria.endereco string
Endereço da agência bancária.
info_agencia_bancaria.numero string
Número do endereço da agência bancária.
info_agencia_bancaria.complemento string
Complemento do endereço da agência bancária.
info_agencia_bancaria.bairro string
Bairro da agência bancária.
info_agencia_bancaria.cep string
CEP da agência bancária.
info_agencia_bancaria.municipio string
Município da agência bancária.
info_agencia_bancaria.uf string
UF da agência bancária.
info_agencia_bancaria.data_inicio string
Data de abertura da agência bancária.
info_agencia_bancaria.ddd string
DDD da agência bancária.
info_agencia_bancaria.telefone string
Telefone da agência bancária.
info_agencia_bancaria.id_instalacao string
ID da instalação da agência bancária.
Retornos disponíveis
Status Request code status message
200 OK 0 OK Pesquisa realizada com sucesso.
200 OK 1 ERROR Banco não cadastrado para validações.
401 Unauthorized 3 ERROR Token inválido.
200 OK 4 ERROR Usuário não contratou nenhum pacote de créditos.
200 OK 5 ERROR Os créditos contratados acabaram.
200 OK 6 ERROR Plugin não existe.
200 OK 7 ERROR Serviço de validação bancária está com instabilidade.
200 OK 8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.
200 OK 9 ERROR Banco inválido.
200 OK 10 ERROR Número da agência inválido.
200 OK 11 ERROR Dígito da agência inválido.
200 OK 12 ERROR Número da conta corrente inválido.
200 OK 13 ERROR Dígito da conta corrente inválido.
200 OK 14 ERROR Dígito da agência não corresponde ao número da agência preenchido.
200 OK 15 ERROR Dígito da conta não corresponde ao número da conta/agência preenchido.