💳Payment Failed

payment.failed
v1.0

Triggered when a payment attempt fails

Subscribe

Webhook Delivery

This event can be delivered to your webhook endpoint

Real-time Streaming

This event does not support real-time streaming

Event Details

Schema definition and example payload

Event Properties

object
id
string
required

Payment transaction ID

bookingId
string

Associated booking ID

amount
number
required

Attempted payment amount

currency
string
required

Currency code

failureReason
string
required

Reason for failure

failedAt
string
required
date-time

Integration Examples

Example code for handling this event

// Handle payment.failed event
app.post('/webhook', async (req, res) => {
  const event = req.body;
  
  if (event.type === 'payment.failed') {
    // Process the event
    console.log('Received Payment Failed:', event.data);
    
    // Your business logic here
    
    // Update payment status
    await updatePaymentStatus(event.data.id, event.data.status);
    
    
  }
  
  res.status(200).json({ received: true });
});