Skip to main content

​
Overview

Webhooks provide real-time notifications when payment and request events occur, enabling immediate response to status changes without constant polling.

​
Event Categories

Payment Events

Core events: confirmed, partial, failed, refundedImmediate notification when payments are processed or fail

Processing Events

Crypto-to-fiat: payment.processing with detailed subStatusTrack multi-step fiat conversion progress

Request Events

Recurring: request.recurringAutomatic subscription renewal generation

Compliance Events

KYC & verification: compliance.updated, payment_detail.updatedUser verification and bank account status changes

​
How It Works

Process:
  1. Event occurs: Payment confirmed, request created, compliance updated
  2. Secure delivery: HMAC SHA-256 signed POST to your configured endpoint
  3. Your processing: Verify x-request-network-signature, update application state
  4. Reliable delivery: 3 retries (1s, 5s, 15s delays) with 5-second timeout

​
Key Features

​
Reliability

  • Idempotency support: Use x-request-network-delivery header for duplicate detection
  • Delivery confirmation: Monitor x-request-network-retry-count header to track attempts

​
Security

  • HMAC SHA-256 signatures: Every webhook includes x-request-network-signature header
  • HTTPS required: Production endpoints must use secure connections
  • Test webhook identification: x-request-network-test header for development

​
Development Tools

  • Portal testing: Send test webhooks from Request Portal
  • ngrok integration: Receive webhooks locally during development
  • Comprehensive logging: Request API logs all delivery failures with attempt details

​
Common Use Cases

  • Invoice systems: Automatically mark invoices as paid when payment.confirmed received
  • Order fulfillment: Release goods or services immediately after payment confirmation
  • Subscription management: Handle request.recurring for automatic billing renewals
  • Compliance workflows: Update user permissions when compliance.updated shows KYC approval
  • Real-time dashboards: Display live payment status using payment.processing subStatus values

​
Implementation

Webhook Reference

Complete technical documentation with setup, payloads, and code examples

Implementation Examples

Working webhook handlers with Express.js and Next.js

Request Portal

Configure webhooks and test delivery

Request Scan

Explore payment transactions and request details