> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Overview

> Real-time event notifications for your HopNow integration

## What are Webhooks?

Webhooks are HTTP callbacks that HopNow sends to your application when specific events occur. Instead of polling the API for changes, webhooks deliver real-time notifications about payments, account updates, and more.

## How Webhooks Work

<Steps>
  <Step title="Register Endpoint">
    Create a webhook endpoint in your application and register it with HopNow
  </Step>

  <Step title="Event Occurs">
    Something happens in your HopNow account (e.g., payment completes)
  </Step>

  <Step title="Webhook Sent">
    We send an HTTP POST request to your endpoint with event details
  </Step>

  <Step title="Acknowledge">
    Your endpoint returns a 2xx status code to confirm receipt
  </Step>
</Steps>

## Available Events

### Deposit Events

* `deposit.received` - Funds credited to an account
* `deposit.returned` - Credited funds returned

### Withdrawal Events

* `withdraw.created` - Withdrawal created
* `withdraw.completed` - Withdrawal completed
* `withdraw.failed` - Withdrawal failed
* `withdraw.cancelled` - Withdrawal cancelled

### Account Events

* `account.created` - Account created
* `account.updated` - Account details or verification state changed

See [Webhook Events](/fx/webhooks/events) for full payload examples.

## Getting Started

1. **[Create a webhook endpoint](/fx/api-reference/webhooks/create-endpoint)** via the API
2. **[Verify signatures](/fx/webhooks/security)** to authenticate incoming webhooks
3. **[Follow best practices](/fx/webhooks/best-practices)** for reliable processing