moeda

Sobre Koin#

Koin é uma prevenção de risco de crédito e fraude para o BNPL brasileiro.

Koin é uma fintech brasileira pioneira e fornecedora líder de soluções Compre Agora, Pague Depois (BNPL) na América Latina, particularmente famosa por seus produtos "Boleto Parcelado" e "PIX Parcelado" (parcelamento).

Capacidades

• Avaliação de dupla ameaça: Avalia uma transação não apenas quanto a fraude de identidade, mas também quanto à qualidade de crédito do consumidor e à probabilidade de inadimplência.
• Mudança de 100% de responsabilidade: Para transações processadas através dos métodos de pagamento alternativos da Koin, eles assumem todo o risco de crédito e fraude, garantindo que você receba o pagamento mesmo se o cliente falhar ou cometer fraude.
• Dados de inclusão financeira: Utiliza fontes de dados alternativas para avaliar consumidores brasileiros sem ou com poucos bancos que podem não ter históricos de crédito tradicionais, mas são compradores legítimos.
• Parcelas locais perfeitas: Possibilita o parcelamento sem risco via Boleto ou PIX sem vincular o limite do cartão de crédito do cliente.

Como funciona com nosso mecanismo de orquestração

Como a Koin toma uma decisão financeira definitiva sobre se financiará a transação, sua API fornece respostas de status claras (Aprovado, Pendente/Revisão, Negado).

Nosso mecanismo de orquestração mapeia um "Aprovado" diretamente para nosso Baixo risco nível (prosseguindo com a captura do pagamento Koin), mapeia "Pendente" para Risco Médio (mantendo o estado do pedido enquanto Koin finaliza as verificações de crédito) e mapeia "Negado" para Alto risco (bloqueando o pagamento Koin, mas permitindo que você retorne/encaminhe para um método de pagamento diferente, como um cartão de crédito padrão via Adyen).

Níveis de risco

A tabela abaixo descreve como as respostas brutas e as pontuações de risco de cada provedor suportado são mapeadas para esses níveis padronizados, juntamente com as ações de roteamento padrão acionadas por cada nível. Tenha em mente que, embora representem nossas configurações padrão, você tem controle total para personalizar o que aciona cada nível de risco para se alinhar perfeitamente ao apetite de risco exclusivo da sua empresa.

Koin avalia fraude e risco de crédito simultaneamente. Suas respostas determinam se eles assumirão a responsabilidade pelo parcelamento.

Requisitos#

Antes de configurar o Koin no DEUNA Admin, você deve ter uma conta de comerciante Koin ativa. Durante a integração, Koin fornece as credenciais para sua integração.

Reúna os seguintes valores do seu gerenciador de integração Koin ou de documentos de integração:

• Org ID: Seu identificador exclusivo de 10 dígitos para sua conta de comerciante.
• Chave privada: Sua chave privada.
• Código da loja
• Tipo de comerciante

Etapas de configuração#

A conexão do Koin é uma configuração única no DEUNA Admin.

Crie a conexão

1. Faça login no seu portal de administração.

2. Acessar Conexões.

3. Procure por Koin e clique Conectar.

4. Um formulário aparecerá. Insira as seguintes informações e credenciais:

   Nome da credencial	Valor	Tipo
   Org ID	Provided by Koin	Obrigatório
   Chave privada	Provided by Koin	Obrigatório
   Ambiente (teste, ao vivo) *	"teste" para Sandbox e "ao vivo" para Produção	Obrigatório
   Código do país (código de 2 caracteres) *	Código do país de 2 dígitos (por exemplo, "MX"	Obrigatório
   Tipo de comerciante (fornecido pela Koin) *	Fornecido pela Koin, caso contrário use "comércio eletrônico" ou "companhia aérea"	Obrigatório
   Categoria do comerciante (MCC, 4 dígitos) *	Código da categoria do comerciante (por exemplo, "3676")	Obrigatório
   Nome Comercial *	Nome do comerciante	Obrigatório
   Modo ouvinte (verdadeiro ou falso) *	Padrão "falso"	Obrigatório
   Código da loja *	Provided by Koin	Obrigatório
   Latitude da loja *	Latitude da loja. Padrão "0"	Opcional
   Armazenar longitude *	Longitude da loja. Padrão "0"	Opcional

5. Clique Salvar.

Configure o ambiente sandbox no DEUNA

1. Abra o Administrador DEUNA e habilitar Modo de teste.
2. Confirme se a conexão Koin usa o test environment.
3. Se você usar a revisão pós-autorização, peça ao seu gerente técnico de contas da DEUNA para ativar a revisão manual e o acompanhamento automático para a loja.

Configure Koin como provedor antifraude na DEUNA

Configure o Koin como um provedor antifraude usando credenciais de teste:

1. Acessar Conexões e abra Koin.
2. Insira as credenciais do teste Koin e selecione o test environment.
3. Acessar Estratégias de pagamento e adicione Koin ao estágio de pré-autorização ou pós-autorização necessário.
4. Ative a estratégia após validar seu pedido de provedor e tratamento de médio risco.

5. Configure a impressão digital do dispositivo

1. Ao conectar-se ao Deuna via widget de pagamento e link de pagamento, siga este guia.

2. Ao conectar-se ao Deuna por API direta, siga este guia.

3. Para qualquer conexão, você deve adicionar Koin no objeto provedores com os seguintes parâmetros:

   JavaScriptCopiar

   	KOIN: { 
   		orgId: '21xx031605'
   	}

4. O parâmetro a configurar é orgId, que faz parte das credenciais de conexão.

5. Para conexões API, envie a saída para DEUNA no device_id campo em base64.

6. Teste a integração

Faça as seguintes transações usando os e-mails:

Abra o pedido resultante no Admin e verifique a decisão de fraude, o status do pagamento e o histórico da operação. As decisões de pré-autorização devem estar disponíveis antes do processamento do pagamento; as decisões de pós-autorização e revisão manual podem ser concluídas de forma assíncrona.

7. Implante Koin na produção

Configure o ambiente de produção:

1. Moeda:
   1. Obtenha acesso ao painel de produção em produção: peça ao Koin as credenciais necessárias
   2. Faça login no painel para configurar a conta
2. DEUNA: Configure o comerciante para Produção no Admin
   1. Desmarque o modo de teste
   2. Configure Koin como um provedor antifraude usando credenciais de produção, configurando live ou production como Meio Ambiente
   3. Configure os gateways de pagamento e estabeleça uma estratégia de pagamento.