OpenCart

a. Sobre

A extensão é compatível com OpenCart versões 2 e 3 e integra os meios de pagamento por Cartão, Boleto e Pix, além de permitir consultar e cancelar as transações de pagamento a partir dos detalhes do pedido na loja OpenCart, atualizar automaticamente a situação do pedido conforme a mudança do status da transação na K8Bank e visualizar o log de informações trocadas entre a loja OpenCart e a API da K8Bank.

b. Requisitos

Credenciais de acesso para API da K8Bank: Client Id, Client Secret e Chave AES. Loja OpenCart conﬁgurada com HTTPS válido, PHP 7.3 ou superior e TLS 1.2 ou superior.
Ter cadastrado na loja OpenCart pelo menos os campos personalizados para CPF, número do endereço e complemento do endereço, conforme a imagem abaixo:

c. Compatibilidade

k8bank-2.0.x-2.2.x.ocmod.zip é compatível com as versões 2.0.1.1 até 2.2.0.0
k8bank-2.3.x.ocmod.zip é compatível com as versões 2.3.0.0 até 2.3.0.2
k8bank-3.0.x.ocmod.zip é compatível com as versões 3.0.1.1 até 3.0.3.8

d. Instalação

Faça o download da extensão compatível com a sua versão do OpenCart.
Acesse a administração da loja OpenCart utilizando um usuário com permissões completas de administrador.
Vá ao menu Extensões→Instalador, clique no botão "Upload", localize o arquivo que você baixou anteriormente e aguarde a conclusão da instalação automática.

Vá ao menu Extensões→Modiﬁcações e clique no botão "Atualizar".

Importante:
No OpenCart 3, no painel de controle da administração da loja, abaixo do botão "Sair", você verá um botão na cor azul com o desenho de uma engrenagem branca dentro dele, clique neste botão, e no popup que vai abrir, clique nos dois botões na cor laranja que estão dentro da coluna "Ação" para atualizar o cache do tema.

Vá ao menu Extensões→Módulos (no OpenCart 2.3 e 3.0 vá ao menu Extensões→Extensões e ﬁltre por Módulos), localize a extensão "K8Bank Integração", clique no botão "Instalar", depois no botão "Editar", preencha os campos e clique no botão "Salvar".

Importante: O módulo K8Bank Integração concentra as funcionalidades básicas que são utilizadas pelos módulos de pagamento a seguir.

Vá ao menu Extensões→Pagamentos (no OpenCart 2.3 e 3.0 vá ao menu Extensões→Extensões e ﬁltre por Pagamentos), localize a extensão "K8Bank Cartão", clique no botão "Instalar", depois no botão "Editar", preencha os campos e clique no botão "Salvar".

Vá ao menu Extensões→Pagamentos (no OpenCart 2.3 e 3.0 vá ao menu Extensões→Extensões e ﬁltre por Pagamentos), localize a extensão "K8Bank Boleto", clique no botão "Instalar", depois no botão "Editar", preencha os campos e clique no botão "Salvar".

Vá ao menu Extensões→Pagamentos (no OpenCart 2.3 e 3.0 vá ao menu Extensões→Extensões e ﬁltre por Pagamentos), localize a extensão "K8Bank Pix", clique no botão "Instalar", depois no botão "Editar", preencha os campos e clique no botão "Salvar"

Importante:
Selecione os campos com os dados do cliente em cada módulo de pagamento, caso contrário os módulos não funcionarão corretamente.
Caso não apareçam os campos personalizados do cliente, isso signiﬁca que eles não foram cadastrados na loja, então siga as instruções destacadas em azul nas conﬁgurações do módulo para acessar a página de campos personalizados do cliente e assim cadastrá-los na loja.

e.Testando

Após instalar e conﬁgurar os módulos K8Bank na loja OpenCart, tendo selecionando corretamente em cada módulo de pagamento os campos referente aos dados do cliente, faça um pedido na loja utilizando um cliente que esteja com os campos CPF, número de telefone com DDD e endereço com número, corretamente preenchidos e com dados válidos.

f. Log de informações

Caso ocorra algum erro ao concluir o pedido através das opções de pagamento da K8Bank, certiﬁque-se que o campo “Debug” no módulo K8Bank Integração está habilitado, e na mesma tela do módulo clique no botão “Log de informações” para visualizar os possíveis erros conforme a imagem abaixo:

Você pode ﬁltrar o log de informações pela data de registro, além de realizar o download do arquivo de log por data e apagar todo o log de informações.

g. Detalhes da transação

Para visualizar os detalhes das transações de pagamento realizadas por meio da K8Bank, acesse a administração da loja OpenCart e visualize os detalhes do pedido, sendo que a aba com os detalhes da transação ﬁca ao lado da aba “Adicional” conforme a imagem abaixo:

É possível consultar a situação das transações no cartão, boleto e Pix, além de cancelar transações aprovadas no cartão de crédito.