Koin

Provedor de soluções de prevenção a fraudes especializado em análise de risco para transações online. A Koin oferece avaliação em tempo real e assíncrona, utilizando inteligência artificial para identificar e mitigar fraudes. Mais informações.

Funcionalidades suportadas pelo antifraude

Provedor	Realtime	Assíncrono

Este serviço ou método é oferecido pelo provedor e suportado pela API da Malga

Este serviço ou método não é oferecido pelo provedor

Este serviço ou método é oferecido pelo provedor e ainda não é suportado pela API da Malga. Caso tenha interesse em utilizar este recurso, contate o nosso time de atendimento pelo e-mail suporte@malga.io.

Não se aplica

Integrando a Koin ao seu checkout

Esta seção guia você passo a passo para integrar a Koin ao seu fluxo de checkout, garantindo a correta prevenção de fraudes.

1. Obtenha seus dados de integração

Após solicitar e receber os dados de integração com a Koin, configure-os no merchant da Malga. Estes dados são essenciais para autenticar e habilitar o serviço.

api-key e client-id: dúvidas sobre api-key e client-id consulte a página sobre autenticação para mais detalhes
secret-key: chave secreta de API fornecida pela Koin para autenticação
org-id: identificador da organização na Koin
store-name: identificador da loja utilizado para segmentar a análise de risco na Koin

curl --location 'https://api.malga.io/v1/merchants' \
--header 'X-Client-Id: <client-id>' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mcc": "4789",
    "providers": [
        {
            "name": "KOIN",
            "priority": 1,
            "credentials": {
                "type": "KOIN",
                "secretKey": "<secret-key>",
                "orgId": "<org-id>",
                "storeName": "<store-name>"
            },
            "options": {
                "type": "ANTIFRAUD",
                "captureOnApproved": true,
                "refundOnReproved": true,
                "runBeforeCharge": false
            }
        }
    ]
}'

2. Configure o fingerprint do dispositivo

A Koin exige a integração do seu SDK JavaScript para coleta de fingerprint do dispositivo. Esta etapa é obrigatória para transações web e deve ser executada antes de enviar a requisição de cobrança. Inclua o script da Koin nas páginas de checkout do seu site. Utilize a URL de sandbox enquanto estiver testando a integração e altere para a URL de produção somente quando o merchant estiver configurado com as credenciais reais da Koin:

index.html

<!-- SDK de Fingerprint da Koin -->
<!-- Sandbox -->
<script type="text/javascript"
  src="https://antifraud-sandbox.koinlatam.com/risk/fingerprint/statics/b-track-min.js"
  id="deviceId_fp"
  org_id="<org-id>">
</script>

<!-- Produção -->
<script type="text/javascript"
  src="https://antifraud.koinlatam.com/risk/fingerprint/statics/track-min.js"
  id="deviceId_fp"
  org_id="<org-id>">
</script>

org-id: identificador da organização fornecido pela Koin

Após a inclusão, capture o sessionId gerado pelo SDK e envie-o no campo browser.browserFingerprint da requisição:

index.js

// Gera e captura o session ID da Koin
getSessionID(function (sessionId) {
    // Utilize o sessionId como browserFingerprint na requisição de cobrança
    console.log("Koin Session ID:", sessionId);
});

Alternativamente, se você já possui um session ID, pode passá-lo diretamente no atributo session_id da tag script (o exemplo abaixo utiliza a URL de sandbox; substitua pela URL de produção quando necessário):

<script type="text/javascript"
  src="https://antifraud-sandbox.koinlatam.com/risk/fingerprint/statics/b-track-min.js"
  id="deviceId_fp"
  org_id="<org-id>"
  session_id="<seu-session-id>">
</script>

Para mais detalhes, consulte a documentação oficial da Koin.

3. Crie uma transação com a API da Malga

Adicione o objeto de fraudAnalysis ao body quando realizar nova cobrança. O campo browser.browserFingerprint deve ser preenchido com o session ID capturado pelo SDK da Koin.

curl --location 'https://api.malga.io/v1/charges' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <client-id>' \
--data-raw '{
    "merchantId": "7f8870a2-71c9-4ef0-a531-82000e00b7e1",
    "amount": 15000,
    "currency": "BRL",
    "statementDescriptor": "LOJA JOAO",
    "description": "Descrição longa da cobrança",
    "capture": false,
    "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
    "paymentMethod": {
        "paymentType": "credit",
        "installments": 1
    },
    "paymentSource": {
        "sourceType": "card",
        "card": {
            "cardNumber": "5261424250184574",
            "cardCvv": "321",
            "cardExpirationDate": "06/2028",
            "cardHolderName": "JOAO DA SILVA"
        }
    },
    "fraudAnalysis": {
        "sla": 10,
        "customer": {
            "name": "Joao Torres",
            "phone": "11 99329899",
            "email": "joao@gmail.com",
            "identity": "45762964851",
            "identityType": "CPF",
            "birthdate": "1990-01-15T00:00:00.000Z",
            "registrationDate": "2022-07-26T16:11:35.756Z",
            "billingAddress": {
                "street": "Rua Um",
                "number": "200",
                "zipCode": "02010010",
                "country": "BR",
                "state": "SP",
                "district": "Jardim Paraiso",
                "city": "Sao Paulo",
                "complement": "ap 10"
            },
            "browser": {
                "browserFingerprint": "<koin-session-id>",
                "ipAddress": "127.0.0.1"
            }
        },
        "cart": {
            "items": [
                {
                    "name": "Tênis Esportivo",
                    "description": "Tênis esportivo masculino tamanho 42",
                    "quantity": 1,
                    "sku": "TNS-42-ESP",
                    "unitPrice": 15000
                }
            ]
        }
    }
}'

Para mais detalhes sobre como realizar uma nova cobrança, consulte a página de novas cobranças.
Se você possui interesse em receber cotações e avaliar este provedor antifraude para o seu fluxo de pagamentos, entre em contato com o nosso time para avaliar.

Comece na Malga

Conexões

Guias

Serviços adicionais

Funcionalidades suportadas pelo antifraude

Integrando a Koin ao seu checkout

1. Obtenha seus dados de integração

2. Configure o fingerprint do dispositivo

3. Crie uma transação com a API da Malga

​Funcionalidades suportadas pelo antifraude

​Integrando a Koin ao seu checkout

​1. Obtenha seus dados de integração

​2. Configure o fingerprint do dispositivo

​3. Crie uma transação com a API da Malga

Funcionalidades suportadas pelo antifraude

Integrando a Koin ao seu checkout

1. Obtenha seus dados de integração

2. Configure o fingerprint do dispositivo

3. Crie uma transação com a API da Malga