Skip to main content

EdenPay Payment Webhooks

Receive real-time notifications when payment events occur in your EdenPay integration.

What are Webhooks?โ€‹

Webhooks enable BlockEden.xyz to push real-time event notifications to your server when important payment events occur. Instead of repeatedly polling our API to check for status changes, your server receives HTTP POST requests containing structured event data the moment something happens.

Why Use Webhooks?โ€‹

  • Real-time notifications: Get instant updates when payments are confirmed, failed, or refunded
  • Reduced API calls: Eliminate the need for polling, saving compute units and improving efficiency
  • Reliable delivery: Automatic retries with exponential backoff ensure events reach you
  • Secure: HMAC-SHA256 signature verification protects against unauthorized requests
  • Scalable: Handle thousands of events without overwhelming your infrastructure

How Webhooks Workโ€‹

  1. You create an endpoint: Set up a public HTTPS URL on your server to receive webhook events
  2. You register the endpoint: Add your URL in the BlockEden dashboard and select which events to receive
  3. Events occur: When a payment is confirmed, fails, or changes status, we create an event
  4. We send the event: BlockEden sends an HTTP POST request to your endpoint with the event data
  5. You process the event: Your server validates the signature, processes the event, and returns a 200 response
  6. We retry if needed: If your endpoint doesn't respond, we automatically retry with exponential backoff

Common Use Casesโ€‹

E-commerce Checkoutโ€‹

Automatically fulfill orders when payment is confirmed, update order status when payments fail, and process refunds.

Subscription Servicesโ€‹

Activate user accounts when initial payment is confirmed, handle failed recurring payments, and manage subscription lifecycle.

Digital Content Deliveryโ€‹

Grant immediate access to purchased content, revoke access for failed payments, and track payment analytics.

Multi-chain Payment Processingโ€‹

Handle payments across multiple blockchain networks with a unified webhook interface.

Event Typesโ€‹

EdenPay webhooks support the following event types:

  • payment.created - A new payment has been initiated
  • payment.pending - Payment transaction has been broadcast to the blockchain
  • payment.confirmed - Payment has been confirmed on-chain (recommended for fulfillment)
  • payment.failed - Payment has failed or expired
  • payment.refunded - Payment has been refunded to the customer
  • checkout.session.created - A new checkout session has been created
  • checkout.session.completed - Checkout session completed successfully
  • checkout.session.expired - Checkout session has expired

Securityโ€‹

All webhook requests include an x-eden-signature header containing an HMAC-SHA256 signature. Always verify this signature before processing events to ensure the request came from BlockEden.

Getting Startedโ€‹

Ready to integrate webhooks? Follow our Quick Start Guide to set up your first webhook endpoint in under 5 minutes.

Documentation Structureโ€‹

Need Help?โ€‹

Share on Twitter