Platform Integrations

Install the KeepSafe App from Shopify App Store

Visit the Shopify App Store and search for "KeepSafe Fraud Protection" or click the button below to install directly.

Get Your API Credentials

From your KeepSafe Dashboard, navigate to Account Settings and copy:

• Your API Key
• Your Client ID

Configure the App in Shopify

Once installed, open the KeepSafe app from your Shopify admin and enter your credentials:

1. Click "Settings" in the KeepSafe app
2. Paste your API Key and Client ID
3. Click "Save Configuration"

Set Your Risk Thresholds

Configure your fraud detection sensitivity from the User Settings page:

• High Risk Threshold: Orders scoring above this will be flagged as high risk
• Medium Risk Threshold: Orders between medium and high will need review

Test the Integration

Place a test order in your Shopify store to verify the integration is working:

1. Create a test order in Shopify
2. Check the order details page - you should see a KeepSafe fraud score
3. Verify the request appears in your KeepSafe Dashboard

Enable Velo on Your Wix Site

Open your Wix Editor and enable Velo:

1. Click Dev Mode in the top menu
2. Click Turn on Dev Mode
3. This will add code files to your site

Store Your API Credentials Securely

Add your KeepSafe credentials to Wix Secrets Manager:

1. Open the Secrets Manager in the Velo sidebar
2. Click + New Secret
3. Create two secrets:
   • KEEPSAFE_API_KEY - Your API Key from KeepSafe dashboard
   • KEEPSAFE_CLIENT_ID - Your Client ID from KeepSafe dashboard

Add Backend Code for Fraud Checking

Create a new backend file backend/fraud-check.jsw:

import { fetch } from 'wix-fetch';
import { getSecret } from 'wix-secrets-backend';

export async function checkOrderFraud(orderData) {
  try {
    const apiKey = await getSecret('KEEPSAFE_API_KEY');
    const clientId = await getSecret('KEEPSAFE_CLIENT_ID');

    const response = await fetch('https://keepsafe.digital/api/fraud-check', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': apiKey,
        'x-client-id': clientId
      },
      body: JSON.stringify({
        email: orderData.buyerEmail,
        ip: orderData.buyerIp || '0.0.0.0',
        fullname: orderData.billingAddress?.fullName,
        billing_address_street_1: orderData.billingAddress?.addressLine1,
        billing_address_city: orderData.billingAddress?.city,
        billing_address_province: orderData.billingAddress?.subdivision,
        billing_address_postcode: orderData.billingAddress?.zipCode,
        billing_address_country: orderData.billingAddress?.country,
        shipping_address_street_1: orderData.shippingAddress?.addressLine1,
        shipping_address_city: orderData.shippingAddress?.city,
        shipping_address_province: orderData.shippingAddress?.subdivision,
        shipping_address_postcode: orderData.shippingAddress?.zipCode,
        shipping_address_country: orderData.shippingAddress?.country,
        telephone_number: orderData.buyerPhone,
        ai_summary: true
      })
    });

    const result = await response.json();
    return result;
  } catch (error) {
    console.error('Fraud check failed:', error);
    return { risk_score: 0, category: 'unknown', error: error.message };
  }
}

Add Order Event Handler

Create or edit backend/events.js to check orders:

import wixData from 'wix-data';
import { checkOrderFraud } from './fraud-check.jsw';

export function wixStores_onNewOrder(event) {
  const order = event.entity;

  // Check fraud score
  checkOrderFraud(order)
    .then(fraudResult => {
      console.log('Fraud check result:', fraudResult);

      // Store result in custom field or take action
      if (fraudResult.risk_score > 20) {
        // High risk - flag for review
        console.warn('High risk order detected!', {
          orderId: order._id,
          score: fraudResult.risk_score,
          category: fraudResult.category,
          summary: fraudResult.summary
        });

        // Optional: Cancel order or add note
        // You can use Wix Stores API to update the order
      }

      // Store fraud data for later reference
      wixData.insert('FraudChecks', {
        orderId: order._id,
        email: order.buyerEmail,
        riskScore: fraudResult.risk_score,
        category: fraudResult.category,
        summary: fraudResult.summary,
        checkedAt: new Date()
      });
    })
    .catch(error => {
      console.error('Failed to check fraud:', error);
    });
}

Create Database Collection (Optional)

To store fraud check results, create a database collection:

1. Open the Database panel in Velo
2. Click + Add a Collection
3. Name it FraudChecks
4. Add these fields:
   • orderId (Text)
   • email (Text)
   • riskScore (Number)
   • category (Text)
   • summary (Text)
   • checkedAt (Date)

Test the Integration

Test your fraud detection setup:

1. Publish your site changes
2. Place a test order in your store
3. Check the Wix Console (Site Monitoring) for fraud check logs
4. Verify the request appears in your KeepSafe Dashboard