{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "type": "kyc.completed",
  "version": 1,
  "timestamp": "2025-01-15T10:30:00.000Z",
  "source": "transaction-service",
  "company_id": "comp_123456789",
  "correlation_id": "corr_987654321"
}

Events

Kyc completed

Triggered when a KYC (Know Your Customer) check completes for a merchant company.

This event is sent after all configured KYC rules have been evaluated for a newly created or updated merchant. The parent organization receives this webhook automatically via Svix.

The rule_executions array contains one entry per rule defined in the active KYC policy. Each entry reports whether the rule passed, found issues, or failed, the expected field values required to pass, the received field values actually observed, and a human-readable description when it did not pass.

WEBHOOK

kyc.completed

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "type": "kyc.completed",
  "version": 1,
  "timestamp": "2025-01-15T10:30:00.000Z",
  "source": "transaction-service",
  "company_id": "comp_123456789",
  "correlation_id": "corr_987654321"
}

Body

application/json

Base structure for all webhook events

string<uuid>

required

Unique event identifier

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

type

enum<string>

required

Event type identifier

Available options:

kyc.completed

Example:

"kyc.completed"

version

integer

required

Event schema version

Example:

1

timestamp

string<date-time>

required

Event timestamp in ISO 8601 format

Example:

"2025-01-15T10:30:00.000Z"

source

string

required

Service that generated the event

Example:

"transaction-service"

company_id

string

required

Company ID associated with the event

Example:

"comp_123456789"

correlation_id

string

required

Correlation ID for event tracking

Example:

"corr_987654321"

payload

object

KYC check result details

Show child attributes

Response

Webhook received successfully

Internal transfer status changed Ledger entry settled

⌘I

Introduction

Merchants

Pricing

Webhooks

Organization Management

User Management

System

Kyc completed

Body

Response