Guides
Webhooks

Webhooks

Webhooks allow you to receive real-time notifications about events in your PayVanta account. This guide explains how to set up and use webhooks.

Setting Up Webhooks

  1. Log in to your PayVanta dashboard
  2. Navigate to Settings > Webhooks
  3. Add your webhook URL where you want to receive notifications
  4. Save the configuration

Webhook Events

Payin Events

  • payin.initiated - Payment initiated
  • payin.success - Payment successful
  • payin.failed - Payment failed
  • payin.refunded - Payment refunded

Payout Events

  • payout.initiated - Payout initiated
  • payout.success - Payout successful
  • payout.failed - Payout failed
  • payout.reversed - Payout reversed

Best Practices

  1. Always verify webhook signatures
  2. Respond quickly to webhook calls (within 5 seconds)
  3. Implement idempotency to handle duplicate events
  4. Use HTTPS for secure communication
  5. Keep your webhook endpoints secure
  6. Monitor webhook delivery and failures
  7. Implement proper error handling
  8. Store webhook events for audit purposes

Common Use Cases

  • Update order status in your system
  • Trigger notifications to customers
  • Update inventory or product availability
  • Generate receipts or invoices
  • Sync payment status with your accounting system
  • Update customer records
  • Trigger automated workflows

Security

  • All webhook calls are made over HTTPS
  • Each webhook includes a signature for verification
  • IP whitelisting is available for additional security
  • Webhook endpoints should be properly secured

Testing

You can test your webhook implementation using the test mode in your dashboard. This allows you to:

  • Send test webhook events
  • Verify your endpoint is receiving events
  • Check your signature verification
  • Test error handling

Troubleshooting

Common issues and solutions:

  • Webhook not received: Check your server logs and firewall settings
  • Signature verification failed: Verify your webhook secret
  • Timeout errors: Ensure your endpoint responds quickly
  • Duplicate events: Implement idempotency
  • SSL/TLS issues: Verify your SSL certificate

Need Help?

If you need help with webhook implementation, contact our support team at support@payvanta.in

PayoutsError Handling