Skip to main content

Webhook Events

Valmi Value can send webhooks for the following events:
  • invoice.created - Invoice generated
  • invoice.paid - Invoice paid
  • outcome.completed - Outcome achieved
  • payment.successful - Payment processed
  • subscription.created - Subscription created
  • subscription.updated - Subscription updated
  • subscription.cancelled - Subscription cancelled

Configuring Webhooks

  1. Navigate to SettingsWebhooks
  2. Click Add Webhook
  3. Configure:
    • URL: Your webhook endpoint
    • Events: Which events to subscribe to
    • Secret: Webhook secret for verification
  4. Save

Webhook Payload

Webhooks send POST requests with JSON payloads:

Webhook Security

Verify webhook authenticity using the webhook secret:

Webhook Retries

Webhooks are retried if your endpoint returns an error:
  • Retry Schedule: 1min, 5min, 15min, 1hr, 6hr, 24hr
  • Max Retries: 6 attempts
  • Timeout: 30 seconds per attempt

Testing Webhooks

Test webhooks using the webhook test endpoint: