Payments Webhook Events

Receive notifications about subscription payment events.

Events

Event	Description
`subscription.payment_success`	Subscription payment succeeded
`subscription.payment_failed`	Subscription payment failed

subscription.payment_success

Triggered when a subscription payment is successfully processed.

Payload

{
    "event": "subscription.payment_success",
    "timestamp": "2024-01-15T08:30:00Z",
    "data": {
        "subscription_id": 456,
        "user_id": 123,
        "plan": "plus",
        "billing_cycle": "monthly",
        "amount": "1499.00",
        "currency": "PHP",
        "payment": {
            "id": "pay_abc123",
            "method": "card",
            "last_four": "4242",
            "brand": "visa"
        },
        "period": {
            "start": "2024-01-15",
            "end": "2024-02-15"
        },
        "paid_at": "2024-01-15T08:30:00Z"
    }
}

subscription.payment_failed

Triggered when a subscription payment fails.

Payload

{
    "event": "subscription.payment_failed",
    "timestamp": "2024-01-15T08:30:00Z",
    "data": {
        "subscription_id": 456,
        "user_id": 123,
        "plan": "plus",
        "billing_cycle": "monthly",
        "amount": "1499.00",
        "currency": "PHP",
        "failure_reason": "insufficient_funds",
        "failure_message": "Your card has insufficient funds",
        "attempt_count": 1,
        "next_retry_at": "2024-01-16T08:30:00Z",
        "failed_at": "2024-01-15T08:30:00Z"
    }
}

Failure Reasons

Reason	Description
`insufficient_funds`	Card has insufficient funds
`card_declined`	Card was declined
`expired_card`	Card has expired
`invalid_card`	Card number is invalid
`processing_error`	Payment processor error
`authentication_required`	3DS authentication required

Use Cases

Payment Tracking

Log all payment events for financial reporting and reconciliation.

Failed Payment Recovery

Trigger email campaigns when subscription.payment_failed is received to recover failed payments.

Access Management

Use payment events to manage feature access in external systems.

Accounting Integration

Forward payment events to accounting software like QuickBooks or Xero.