Skip to main content

Kount 360 Integration Overview

The Kount Fraud Evaluation Integration is an Integrations Hub Integration that provides real-time fraud detection for EPCC application clients (i.e. storefronts, AI agents) using Kount's risk evaluation services. This integration enables:

  • Pre-checkout risk assessment - Evaluate fraud risk before order completion
  • Automated order fulfillment updates - Sync fulfillment status with Kount for improved accuracy
  • Configurable business rules - Customize fallback decisions when Kount is unavailable
  • Comprehensive error handling - Robust error management with detailed logging

Key Capabilities​

  • Synchronous risk evaluation during checkout flow
  • Asynchronous order fulfillment tracking via webhooks
  • Automatic webhook management during instance lifecycle
  • Configurable fallback decisions when Kount services are unavailable
  • Request correlation tracking for debugging and monitoring

Architecture​

The integration consists of three main flows:

1. Init Flow (Deployment)​

  • Type: Asynchronous lifecycle flow
  • Purpose: Manages integration instance deployment and deletion
  • Actions:
    • Configures EPCC webhooks for order fulfillment tracking
    • Cleans up webhooks during instance deletion

2. Risk Evaluation Flow​

  • Type: Synchronous API endpoint
  • Purpose: Evaluates fraud risk for carts before checkout
  • Actions:
    • Retrieves EPCC cart data with line items
    • Transforms cart to Kount order format
    • Sends order to Kount for risk evaluation
    • Stores Kount order ID and fulfillment mappings in EPCC cart
    • Returns risk decision and score

3. Order Fulfillment Flow​

  • Type: Asynchronous webhook handler
  • Purpose: Updates Kount with order fulfillment status
  • Actions:
    • Validates EPCC webhook security
    • Processes order.fulfilled events
    • Updates Kount with fulfillment status changes

Prerequisites​

EPCC Requirements​

  • EPCC Store: Active Elastic Path Commerce Cloud store
  • API Credentials: Client ID and Secret with appropriate permissions
  • Store Configuration: Access to webhook management

Kount Requirements​

  • Kount Account: Active Kount 360 account
  • API Access: OAuth2 credentials for Kount API
  • Integration Setup: Configured merchant settings in Kount portal

Prismatic Platform​

  • Integrations Hub: Access to Integrations Hub
  • Instance Management: Permissions to deploy and configure integrations

Flow Reference​

Flow NameEndpoint TypeSynchronousPurpose
Init FlowLifecycleNoInstance deployment/deletion management
Risk Evaluation FlowREST APIYesReal-time fraud risk assessment
Order Fulfillment FlowWebhookNoOrder status synchronization

Flow Relationships​

Configuration​

The integration requires configuration across three main areas:

Connection Configuration​

  • EPCC Connection: OAuth2 client credentials for EPCC API access
  • Kount Connection: OAuth2 credentials and API settings for Kount services

Integration Settings​

  • Webhook Security: Auto-generated secret key for EPCC webhook validation
  • Logging Level: Configurable logging verbosity (error, warn, info, debug, trace)
  • Risk Evaluation: Enable/disable immediate risk inquiry
  • Fallback Decisions: Default decision when Kount is unavailable

Business Configuration​

  • Channel Settings: Identifier sent to Kount for order classification
  • Fulfillment Defaults: Default fulfillment type, shipping provider, and method

For detailed configuration instructions, see: Configuration Guide

API Reference​

Risk Evaluation API​

  • Method: POST
  • Type: Synchronous
  • Purpose: Evaluate cart fraud risk before checkout
  • Authentication: X-API-key header, generated during configuration

Order Fulfillment Webhook​

  • Method: POST
  • Type: Asynchronous
  • Purpose: Process EPCC order fulfillment events
  • Authentication: EPCC webhook secret validation

For complete API documentation, see: API Reference

Getting Started​

  1. Review Prerequisites: Ensure you have the required EPCC store, Kount account, and Prismatic access
  2. Configure Connections: Set up EPCC and Kount API credentials
  3. Create Integration Instance: Create and configure the integration instance
  4. Test Integration: Verify risk evaluation and webhook functionality
  5. Go Live: Enable production traffic through the integration

Support and Troubleshooting​

Logging and Monitoring​

  • All requests include correlation IDs for tracing
  • Configurable log levels for debugging
  • Processing time tracking for performance monitoring

Error Handling​

  • Comprehensive error classification codes
  • Fallback decisions for service unavailability
  • Detailed error messages with correlation tracking

Common Issues​

  • Webhook Authentication: Verify webhook secret configuration
  • API Timeouts: Check network connectivity and API limits
  • Missing Cart Data: Ensure required cart fields are populated
  • Kount Configuration: Verify merchant settings in Kount portal

For specific configuration details, refer to the Configuration Guide and API Reference.