K8 conta- Realiza a consulta de uma determinada conta
Permite que usuários autorizados recuperem informações abrangentes sobre uma conta específica no sistema de pagamentos. Essa API otimiza a gestão de contas, fornecendo uma visão centralizada dos atributos da conta, permitindo que os usuários verifiquem os detalhes da conta, gerenciem as configurações da conta e acessem serviços relacionados à conta.
Consulta os dados e credenciais de uma conta.
Decodificar a Payload:
- É necessário converter a string Base64 URL Safe de volta para a forma original. A string criptografada foi modificada para ser segura para URLs, substituindo os caracteres + e / por - e, respectivamente.
- Use uma função para substituir - por + e por /, em seguida, realize a decodificação Base64 (base64decode).
Descriptografar a Payload:
Será necessário utilizar o algoritmo AES-128-CBC para descriptografar a payload. Você precisará da chave de criptografia e de um vetor de inicialização (IV).
O IV utilizado durante a criptografia deve ser o mesmo durante a descriptografia. No nosso caso, utilizamos um IV preenchido com bytes nulos.
Segue exemplo de uma função utilizando a linguagem PHP:
function base64UrlDecode(string $value)
{
return base64_decode(str_replace(['-', ''], ['+', '/'], $value));
}
function decryptResponse($data, $key = '')
{
return openssl_decrypt(base64UrlDecode($data), 'AES-128-CBC', $key, OPENSSL_RAW_DATA, (pack('x'.openssl_cipher_iv_length('AES-128-CBC'))));
}
$decryptedPayload = $this->decryptResponse($payload);
A chave para descriptografar o payload deve ser solicitada via email.
Requisição
Campo | Tipo | Descrição | Obrigatoriedade |
---|---|---|---|
client-id | Texto | Client ID enviado no Header | Sim |
cnpj | Texto | CNPJ da conta | Sim |
Resposta
Campo | Tipo | Descrição |
---|---|---|
message | Texto | Mensagem de retorno |
cnpj | Texto | CNPJ da conta consultada |
dadosBancarios | - | Dados bancários da conta consultada |
Agencia - numero | Texto | Número da agência da conta consultada |
Agencia - dv | Texto | Número identificador da agência da conta consultada |
Conta - numero | Texto | Número da conta da conta consultada |
Conta - dv | Texto | Número identificador da conta da conta consultada |
credenciaisApis | - | Credenciais de API integradas da conta |
Conta - clientId | Texto | Client ID da API Clientes |
Conta - clientSecret | Texto | Client Secret da API Clientes |
Gateway - clientId | Texto | Client ID do Gateway integrado |
Gateway - secret | Texto | Client Secret do Gateway integrado |
Gateway - aesKey | Texto | AES Key do Gateway integrado |
Cobranças - clientId | Texto | Client ID do Cobranças |
Cobranças - secret | Texto | Client Secret do Cobranças |
Cobranças - aesKey | Texto | AES Key do Cobranças |
Cliente - clientePagamentosId | Texto | Client ID de Pagamentos |