1 configurando meio de pagamento Externo Genérico

1 Configurando meio de pagamento Externo Genérico

Acesse Configs > Meios de Pagamento > Adicionar meio de pagamento > Pagamento Externo Genérico, e em seguida, próximo passo



2 Dados gerais

Em Dados Gerais, pode configurar o nome desejado para a identificação:


Obs: O nome parametrizado aqui, será identificado no admin.


3 Integrações

3.1 Configurando Integrações

A seguir, os campos abaixo são de suma importância para que a integração e finalização de pedidos com o parceiro funcione de forma adequada:

  • ClientID: Dado fornecido pela Koin, e é o ID único que identifica o lojista.
  • Chave de autenticação: Dado fornecido pela Koin, E é um código secreto utilizado para identificar e autenticar uma aplicação ou loja em um sistema de pagamento.
  • Token de autenticação: Dado fornecido pela Koin, é o código gerado que permite a verificação e efetua as transações.
  • D Url de criação: Url que é fornecida pela Koin para a criação de um pedido no momento da finalização da compra.
  • E Url de consulta: Utilizada para realizar consulta de status de pagamento na API do parceiro.
  • F Url de cancelamento: Utilizada para realizar chamadas de cancelamento de pagamentos.
  • G Moeda: A moeda será BRL.
  • H OrgID: Identificador da organização que utiliza o serviço (Provedor da Koin)
  • I AccountID: Trata-se do identificado da conta na Koin.


As URLs são fornecidas pelo parceiro Koin. Para garantir o funcionamento no ambiente SandBox, é necessário inserir as URLs específicas para esse ambiente. O mesmo procedimento deve ser seguido para o ambiente de produção (PRD).

Abaixo, seguem alguns exemplos:

Sandbox:

Url de criação: https://api-sandbox.koin.com.br/

Url de consulta: https://api-sandbox.koin.com.br/consulta/

Url de cancelamento: https://api-sandbox.koin.com.br/cancelamento/


PRD:

Url de criação; https://api.koin.com.br/

Url de consulta: https://api.koin.com.br/consulta/

Url de cancelamento: https://api.koin.com.br/cancelamento/


O item D (Url de criação) é altamente importante, visto que o mesmo realizará a criação do pedido.

Já os tens E (Url de consulta) e F (Url de cancelamento) não são obrigatórios, visto que o backend irá realizar esta função.



3.2 Painel de PIX

Este campo não é necessário parametrizações, visto que a integração junto a Koin é o redirecionamento da finalização do pedido para a aplicação do parceiro.



4 Personalizado

Na aba "Personalizado", para que os campos supramencionados funcionem de maneira adequada, em "parceiro" deverá ser Koin



Título:

Ao preencher o campo "Título", ele poderá ser identificado na finalização do pedido com o botão de redirecionamento:

Descrição:

Este campo irá refletir a informação ao botão de seleção do meio de pagamento.

Ao passar o mouse encima do logo, também irá apresentar o nome do título.


5 Aba de PIX

Essa aba não será necessário sua configuração, visto que o funcionamento será externo, e por default, será inativa:

 


6 Promoções

Esta aba relaciona as promoções atreladas ao meio de pagamento apresentado.

  • Quando não há promoções, o comportamento é não retornar nada listado;

  • Quando há promoções atrelada ao meio de pagamento, irá ser listada na mesma tela: