> ## Documentation Index
> Fetch the complete documentation index at: https://docs.publica.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Instant Payment Notifications (IPNs)

Instant Payment Notifications (IPNs) allow payment processors to communicate directly with your Publica.la store about transaction events. Unlike webhooks, IPNs are sent directly from the payment provider rather than from the Publica.la platform.

:::info
For a high-level overview of notification options, see the [Notifications Overview](./overview.md).
:::

## Why Use IPNs?

IPNs provide several advantages:

- Direct communication from payment processors
- Faster notification of payment status changes
- Additional verification layer separate from Publica.la webhooks
- Payment provider-specific data and formats

## Supported Payment Processors

### Stripe

To configure Stripe IPNs:

1. Access your Stripe Dashboard webhooks section at [https://dashboard.stripe.com/webhooks](https://dashboard.stripe.com/webhooks)
2. Click the **+ Add endpoint** button
3. Enter the IPN URL: `https://{store_final_domain}/payment/ipn/stripe`
4. Select the following events:
   - `charge.dispute.closed`
   - `invoice.updated`
   - `customer.subscription.trial_will_end`
   - `customer.subscription.updated`
   - `customer.subscription.deleted`
   - `customer.subscription.created`
   - `charge.updated`
   - `charge.succeeded`
   - `charge.refunded`
   - `charge.pending`
   - `charge.failed`
   - `charge.expired`
   - `charge.captured`
   - `checkout.session.completed`
5. Save the configuration

### MercadoPago

To configure MercadoPago IPNs:

1. Access your MercadoPago Dashboard notifications section at `/developers/panel/notifications/ipn`
2. Add the IPN URL: `https://{store_final_domain}/payment/ipn/mercadopago`
3. Select the following events:
   - `payment`
   - `merchant_order`
4. Save the configuration

## Best Practices

1. **Use Both Webhooks and IPNs**: For critical payment flows, use both Publica.la webhooks and payment processor IPNs for redundancy
2. **Verify Source**: Always verify that IPNs are coming from legitimate payment processors
3. **Idempotent Processing**: Design your systems to handle potential duplicate notifications
4. **Monitor Failures**: Set up monitoring for failed or missed IPN notifications

## Related Documentation

- [Notifications Overview](./overview.md)
- [Webhooks & Sales Notifications](./webhooks-int.md)