Skip to main content

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.

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
  2. Click the + Add endpoint button
  3. Enter the IPN URL: https://{your-store}/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://{your-store}/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
X

Graph View