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

​
Payment Events

  • payin.created - Incoming payment initiated
  • payin.completed - Incoming payment successful
  • payin.failed - Incoming payment failed
  • payout.created - Outgoing payment initiated
  • payout.completed - Outgoing payment successful
  • payout.failed - Outgoing payment failed

​
Account Events

  • account.created - New account created
  • account.updated - Account information changed
  • account.deactivated - Account deactivated

​
Beneficiary Events

  • beneficiary.created - Beneficiary added
  • beneficiary.updated - Beneficiary details changed
  • beneficiary.deleted - Beneficiary removed
  • beneficiary.disabled - Beneficiary disabled
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