Skip to main content

Configuration Guide

Complete reference for all Signifyd for WooCommerce settings and options.

Settings Location​

Navigate to Settings > Signifyd in WordPress admin to access all plugin configuration options.

API Settings​

Enable Plugin​

Type: Checkbox
Default: Unchecked

Enables or disables all Signifyd functionality. When unchecked, orders will not be submitted to Signifyd regardless of other settings.

Usage:

☑ Enable Plugin

Use Cases:

  • Temporarily disable fraud detection without deactivating plugin
  • Emergency stop for troubleshooting
  • Maintenance mode during Signifyd account changes

Development Mode​

Type: Select
Options: Production, Development
Default: Production

Determines which Signifyd environment to use:

  • Production — Live environment for real orders
  • Development — Test environment for development and testing

Usage:

Development Mode: [Production ▼]

Best Practice: Use Development mode during initial setup and testing. Switch to Production only after confirming everything works correctly.

Production API Key​

Type: Text
Required: Yes (when in Production mode)

Your Signifyd production API key for live order submissions.

Format: Alphanumeric string (typically 40 characters)

Example:

abc123def456ghi789jkl012mno345pqr678st

Security: Never commit API keys to version control or share publicly.

Development API Key​

Type: Text
Required: Yes (when in Development mode)

Your Signifyd development/test API key for testing integrations.

Format: Alphanumeric string (typically 40 characters)

Enable Burn-in Mode​

Type: Checkbox
Default: Unchecked

When enabled, orders are sent to Signifyd for analysis, but the plugin takes no automatic action based on decisions. This allows you to observe Signifyd's decisions without affecting order fulfillment.

Usage:

☑ Enable Burn in Mode

Description: "This will send all orders to Signifyd but not act on them when enabled."

Use Cases:

  • Initial testing and validation
  • Gradual rollout to production
  • Decision accuracy assessment
  • Training and familiarization

Recommended Workflow:

  1. Enable burn-in mode
  2. Monitor decisions for 1-2 weeks
  3. Review accuracy and false positive rate
  4. Disable burn-in when confident

Advanced Settings​

Email Notifications​

Type: Text (email address)
Default: Empty

Email address to receive notifications about fraud alerts and order decisions.

Format: Valid email address

Example:

[email protected]

Notifications Sent:

  • High-risk order detections
  • Orders rejected by Signifyd
  • Webhook failures or errors
  • API communication issues

Starting Post ID​

Type: Number
Default: 0

Only submit orders with an ID greater than this value to Signifyd. Useful for enabling the plugin on existing stores without sending historical orders.

Example:

Starting Post Id: 5000

Use Cases:

  • Prevent backlog of old orders
  • Enable plugin mid-operation without reprocessing
  • Control which orders get fraud screening

How It Works:

if ( $order->get_id() <= $starting_post_id ) {
    // Skip this order
    return;
}

Fulfillment Settings​

Enable Fulfillment​

Type: Checkbox
Default: Unchecked

Enable sending fulfillment data back to Signifyd when orders ship. This improves fraud detection accuracy and is required for Signifyd's Chargeback Guarantee.

Usage:

☑ Enable Fulfillment

Benefits:

  • Better fraud detection over time
  • Chargeback protection eligibility
  • Historical data for machine learning
  • Complete order lifecycle tracking

Fulfillment Origin Address​

Configure the ship-from address for fulfillment requests:

Address
Type: Text
Example: 123 Warehouse St

City
Type: Text
Example: Chicago

State
Type: Text (2 characters)
Example: IL

Zip Code
Type: Text
Example: 60601

Country
Type: Text (2 characters)
Example: US

Purpose: Provides origin location for shipment tracking and fraud pattern analysis.

Status to Send Fulfillment (WIP)​

Type: Select
Options: WooCommerce order statuses
Default: None

Select which order status triggers fulfillment data submission to Signifyd.

Common Options:

  • wc-completed — Order marked as completed
  • wc-shipped — Custom shipped status
  • Depends on your workflow and status setup

Note: This is a Work in Progress feature. Implementation may vary.

Configuration Best Practices​

Initial Setup (Testing)​

✅ Enable Plugin: Checked
✅ Enable Burn-in Mode: Checked
✅ Development Mode: Development
✅ Development API Key: [Your test key]
❌ Enable Fulfillment: Unchecked

Production Configuration (Live)​

✅ Enable Plugin: Checked
❌ Enable Burn-in Mode: Unchecked
✅ Development Mode: Production
✅ Production API Key: [Your live key]
✅ Enable Fulfillment: Checked
✅ Email Notifications: [email protected]
✅ Starting Post ID: [Current max order ID]

Gradual Rollout​

✅ Enable Plugin: Checked
✅ Enable Burn-in Mode: Checked (for 1 week)
✅ Development Mode: Production
✅ Production API Key: [Your live key]

After monitoring:

❌ Enable Burn-in Mode: Unchecked (enable actions)

Settings Storage​

All settings are stored in a single WordPress option:

Option Name: suma_signifyd_plugin_options
Format: Serialized array

Example structure:

array(
    'enable' => '1',
    'enable_burn_in' => '0',
    'dev_mode' => 'prod',
    'api_key_prod' => 'abc123...',
    'api_key_dev' => 'test456...',
    'enable_fulfillment' => '1',
    'signifyd_email_notifications' => '[email protected]',
    'starting_post_id' => '5000',
    'address' => '123 Main St',
    'city' => 'Chicago',
    'state' => 'IL',
    'zip' => '60601',
    'country' => 'US',
)

Retrieving Settings in Code​

Access settings anywhere in WordPress:

$settings = get_option('suma_signifyd_plugin_options');

// Or use the constant:
$api_key = SUMA_SIGNIFYD_SETTINGS['api_key_prod'];

Environment Variables (Alternative)​

For security, you can define API keys in wp-config.php:

define('SUMA_SIGNIFYD_API_KEY_PROD', 'your-production-key');
define('SUMA_SIGNIFYD_API_KEY_DEV', 'your-development-key');

Then modify the plugin to check for constants before using settings values.

Next Steps​