ClearSale

A ClearSale é uma empresa brasileira especializada em soluções de prevenção e gestão de fraudes para e-commerce e meios de pagamento. Em nossa integração, pode atuar em modo realtime e/ou assíncrono para análise de risco de transações. 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 ClearSale ao seu checkout

Esta seção guia você passo a passo para integrar a ClearSale 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, 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
merchant-id, username, password: converse com nosso time para obter as credenciais
app (opcional): identifica o APP na ClearSale quando necessário para o link de pagamento da Malga

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": "CLEARSALE",
            "priority": 1,
            "credentials": {
                "type": "CLEARSALE",
                "name": "<username>",
                "password": "<password>",
                "app": "<app>"
            },
            "options": {
                "type": "ANTIFRAUD",
                "captureOnError": false,
                "captureOnApproved": true,
                "refundOnError": false,
                "refundOnReproved": true,
                "runBeforeCharge": false
            }
        }
    ]
}'

O campo credentials.app é opcional e usado pelo fluxo de link de pagamento hospedado pela Malga. Ele não substitui a configuração do script de tracking no passo 2 quando você integra checkout ou link de pagamento próprio. Para mais detalhes sobre cadastro de merchants, consulte a página criação de novos merchants

2. Configure o script de tracking

Se você usa checkout ou link de pagamento próprio, deve incluir o script de fingerprint da ClearSale no HTML. Para a captura, serão necessárias 2 informações:

SEU_APP: nome do APP na ClearSale (obtido junto com eles)
SEU_SESSION_ID: valor que você enviará na cobrança em fraudAnalysis.customer.browser.browserFingerprint. Toda vez que o usuário deixar a página sem concluir a transação e retornar posteriormente esse valor deve ser atualizado.

index.html

<script>
    (function (a, b, c, d, e, f, g) {
    a['CsdpObject'] = e; a[e] = a[e] || function () {
    (a[e].q = a[e].q || []).push(arguments)
    }, a[e].l = 1 * Date.now(); f = b.createElement(c),
    g = b.getElementsByTagName(c)[0]; f.async = 1; f.src = d; g.parentNode.insertBefore(f, g)
    })(window, document, 'script', '//device.clearsale.com.br/p/fp.js', 'csdp');
    csdp('app', '<SEU_APP>');
    csdp('sessionid', '<SEU_SESSION_ID>');
</script>

Substitua os placeholders pelos valores reais da sua integração.

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

Adicione o objeto de fraudAnalysis ao body quando realizar nova cobrança. Preencha fraudAnalysis.customer.browser.browserFingerprint com o sessionId obtido no passo 2.

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": "<merchant-id>",
    "amount": 150,
    "currency": "BRL",
    "statementDescriptor": "LOJA JOAO",
    "description": "Descrição longa da cobrança",
    "capture": false,
    "orderId": "<order-id>",
    "paymentMethod": {
        "paymentType": "credit",
        "installments": 1
    },
    "paymentSource": {
        "sourceType": "card",
        "card": {
            "cardNumber": "5261424250184574",
            "cardCvv": "321",
            "cardExpirationDate": "06/2028",
            "cardHolderName": "JOAO DA SILVA"
        }
    },
     "fraudAnalysis": {
        "mfa": { 
            "smsOtpUsed": true, 
            "emailOtpUsed": true 
        },
        "customer": {
            "name": "John Doe",
            "identity": "12345678909",
            "identityType": "CPF",
            "secondaryIdentity": "11222333000181",
            "secondaryIdentityType": "CNPJ",
            "email": "john.doe@example.com",
            "birthdate": "1990-01-01",
            "registrationDate": "2023-01-01 10:00:00",
            "phone": "+5511999999999",
            "maritalStatus":"Solteiro", 
            "education":"Ensino Superior Completo", 
            "billingAddress": {
                "street": "Rua A",
                "number": "123",
                "complement": "Apto 45",
                "zipCode": "01000-000",
                "city": "São Paulo",
                "state": "SP",
                "country": "BR",
                "district": "Centro",
                "reference": "Próximo à praça"
            },
            "deliveryAddress": {
                "street": "Rua B",
                "number": "456",
                "complement": "Casa",
                "zipCode": "02000-000",
                "city": "São Paulo",
                "state": "SP",
                "country": "BR",
                "district": "Vila X",
                "reference": "Portão azul"
            },
            "browser": {
                "browserFingerprint": "fp-abc-123",
                "cookiesAccepted": true,
                "email": "john.browser@example.com",
                "hostName": "example.com",
                "ipAddress": "203.0.113.10",
                "type": "Chrome"
            },
            "gender": "male"
        },
        "cart": {
            "items": [
                {
                    "name": "Produto 1",
                    "quantity": 1,
                    "sku": "SKU-001",
                    "unitPrice": 1000,
                    "risk": "Low",
                    "description": "Descrição do produto",
                    "categoryId": "123",
                    "locality": "SP",
                    "date": "2025-09-10 12:00:00",
                    "type": 1,
                    "genre": "xpto"
                }
            ],
            "isGift": true,
            "giftMessage": "Parabéns!"
        },
        "device": {
            "id": "device-123",
            "os": {
                "type": "iOS",
                "version": "16.5"
            },
            "model": "iPhone 14",
            "resolution": "1170x2532",
            "ramCapacity": 4096,
            "diskCapacity": 128000,
            "freeDiskSpace": 64000,
            "vendors": [
                {
                    "name": "carrier",
                    "value": "Vivo"
                }
            ],
            "vendorAttributes": {
                "flash": true,
                "phoneCalls": true,
                "sendSms": true,
                "videoCamera": true,
                "cpuCount": 8,
                "simulator": false,
                "retinaDisplay": true,
                "frontCamera": true,
                "camera": true,
                "language": "pt-BR",
                "idiom": "pt-BR",
                "platform": "mobile",
                "name": "Apple",
                "family": "iPhone",
                "model": "14"
            }
        },
        "airline": {
            "passengers": [
                {
                    "name": "John Doe",
                    "companyMileCard": "LATAM",
                    "mileCard": "MILE-12345",
                    "identityType": "CPF",
                    "identityNumber": "12345678909",
                    "gender": "male",
                    "birthdate": "1990-01-01",
                    "cpf": "12345678909"
                }
            ],
            "connections": [
                {
                    "company": "LATAM",
                    "identificationNumber": 1234,
                    "date": "2025-09-15 10:00:00",
                    "seatClass": "Economy",
                    "origin": "GRU",
                    "destination": "GIG",
                    "boarding": "2025-09-15 09:30:00",
                    "arriving": "2025-09-15 11:30:00",
                    "fareClass": "Y"
                }
            ],
            "reservation": "2025-09-01"
        },
        "orderOrigin": "web",
        "operationalSystem": "iOS 16.5",
        "marketplaceType": "b2c",
        "purchaseInformation": {
            "lastDateInsertedMail": "2025-06-01",
            "lastDateChangePassword": "2025-07-01",
            "lastDateChangePhone": "2025-06-15",
            "lastDateChangeMobilePhone": "2025-06-16",
            "lastDateInsertedAddress": "2025-05-20",
            "purchaseLogged": true,
            "email": "user@example.com",
            "login": "userlogin"
        },
        "socialNetwork": {
            "optInCompreConfie": true,
            "socialNetworkType": "facebook",
            "authenticationToken": "token-abc"
        },
        "giftList": {
            "type": "wedding_list",
            "id": "list-123"
        },
        "hotels": [
            {
                "name": "Hotel ABC",
                "city": "São Paulo",
                "state": "SP",
                "country": "BR",
                "reservationDate": "2025-10-01",
                "reserveExpirationDate": "2025-09-20",
                "checkInDate": "2025-10-05",
                "checkOutDate": "2025-10-10"
            }
        ],
        "country": "BR"
    }
}'

Para mais detalhes sobre como realizar uma nova cobrança, consulte a página de novas cobranças.

Comece na Malga

Conexões

Guias

Serviços adicionais

Funcionalidades suportadas pelo antifraude

Integrando a ClearSale ao seu checkout

1. Obtenha seus dados de integração

2. Configure o script de tracking

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

​Funcionalidades suportadas pelo antifraude

​Integrando a ClearSale ao seu checkout

​1. Obtenha seus dados de integração

​2. Configure o script de tracking

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

Funcionalidades suportadas pelo antifraude

Integrando a ClearSale ao seu checkout

1. Obtenha seus dados de integração

2. Configure o script de tracking

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