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 |
