Overview

Integrating FraudHawkAI with your WooCommerce store allows you to detect and prevent COD fraud in real-time. When a customer places an order, we analyze the order data and provide you with a risk score so you can make informed decisions before dispatching.

How it works

1. Customer places an order
2. WooCommerce creates the order
3. A webhook is triggered
4. FraudHawkAI analyzes the order
5. A risk score is generated
6. You take action

---

Prerequisites

Before you begin, make sure you have:

• A FraudHawkAI account — sign up here
• Your API key — found in Dashboard → API Key
• Your webhook token — found in Dashboard → Webhooks
• A WooCommerce store on version 5.0 or higher

---

Step-by-step setup

Step 1: Get your webhook URL

1. Log in to your FraudHawkAI dashboard
2. Navigate to Dashboard → Webhooks
3. Copy your webhook URL

Your webhook URL will look like this:

https://www.fraudhawkai.com/api/webhooks/woocommerce?token=frgk_your_webhook_token

Note: This URL contains your unique token. Keep it secure and never share it publicly.

Step 2: Open WooCommerce webhook settings

1. Log in to your WooCommerce admin dashboard
2. Go to WooCommerce → Settings
3. Click the Advanced tab
4. Click Webhooks

Step 3: Create the "Order created" webhook

1. Click Add webhook
2. Configure the webhook using the values below
3. Click Save webhook

Step 4: Create the "Order updated" webhook

1. Click Add webhook
2. Configure the webhook using the values below
3. Click Save webhook

Important: Create separate webhooks for both "Order created" and "Order updated" events to capture all order activity.

Step 5: Test your integration

1. Place a test order in your WooCommerce store
2. Check the delivery status under WooCommerce → Settings → Advanced → Webhooks
3. Confirm the webhook shows a successful delivery (200 status)
4. Log in to your FraudHawkAI dashboard to see the order appear

---

Webhook delivery URL format

Your webhook URL follows this format:

https://www.fraudhawkai.com/api/webhooks/woocommerce?token={your-webhook-token}

---

What data we receive

When an order is placed, WooCommerce sends a payload similar to the one below:

{
  "id": 1234,
  "order_number": "1001",
  "status": "processing",
  "currency": "PKR",
  "total": "15000.00",
  "billing": {
    "first_name": "Ahmed",
    "last_name": "Raza",
    "email": "ahmed@example.com",
    "phone": "03001234567",
    "address_1": "House #123, Street 5",
    "city": "Karachi",
    "state": "Sindh",
    "postcode": "75500",
    "country": "PK"
  },
  "shipping": {
    "first_name": "Ahmed",
    "last_name": "Raza",
    "address_1": "House #123, Street 5",
    "city": "Karachi",
    "state": "Sindh",
    "postcode": "75500",
    "country": "PK"
  },
  "line_items": [
    {
      "name": "Product Name",
      "quantity": 2,
      "price": "5000.00",
      "total": "10000.00"
    }
  ],
  "payment_method": "cod"
}