Callback Authentication

PearCheck sends authenticated POST callbacks to your specified URLs for verification events. Configure callback URLs and security headers through your PearCheck dashboard or API requests.

Callback Types

Verification Callback

Trigger: Automated verification completion
Parameter: callback_url

{
  "callback_url": "https://yourdomain.com/verify-callback"
}

Events Callback

Trigger: Manual actions (e.g. dashboard updates)
Parameter: events_callback_url

{
  "events_callback_url": "https://yourdomain.com/events-callback"
}

Setting Callback URLs

Method 1: Global Settings

Navigate to Dashboard > Settings
Set default callback URLs
Applies to all verifications unless overridden

Method 2: Per-Request

{
  "callback_url": "https://yourdomain.com/custom-callback",
  "events_callback_url": "https://yourdomain.com/custom-events"
}

Authentication

To ensure callbacks originate from PearCheck, verify the X-PearCheck-Signature header containing a signature set on your account.

Step 1: Set Your Secret Key

Navigate to Dashboard > Settings
Locate the “Signature Secret” section
Enter your custom secret
Compare your custom secret with the X-PearCheck-Signature header sent by PearCheck
X-PearCheck-Signature: your_shared_secret_here

Quick Start

User Verification (KYC)

Business Verification (KYB)

Callback Types

Verification Callback

Events Callback

Setting Callback URLs

Method 1: Global Settings

Method 2: Per-Request

Authentication

Step 1: Set Your Secret Key

​Callback Types

​Verification Callback

​Events Callback

​Setting Callback URLs

​Method 1: Global Settings

​Method 2: Per-Request

​Authentication

​Step 1: Set Your Secret Key

Callback Types

Verification Callback

Events Callback

Setting Callback URLs

Method 1: Global Settings

Method 2: Per-Request

Authentication

Step 1: Set Your Secret Key