Skip to main content

​
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

1

Register Endpoint

Create a webhook endpoint in your application and register it with HopNow
2

Event Occurs

Something happens in your HopNow account (e.g., payment completes)
3

Webhook Sent

We send an HTTP POST request to your endpoint with event details
4

Acknowledge

Your endpoint returns a 2xx status code to confirm receipt

​
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 for full payload examples.

​
Getting Started

  1. Create a webhook endpoint via the API
  2. Verify signatures to authenticate incoming webhooks
  3. Follow best practices for reliable processing