Webhooks Use Case guides

A comprehensive guide to managing webhook events, including use cases, and links to our documentation.

Overview

This Quick Start Guide walks you through different use cases you may encounter with Webhooks on Recurly.

Synchrous Payments and Transactions

Payment Methods such as Credit Cards and Instant payments such as Cash App, PayPal, and Venmo will return an immediate authorization response, providing a clear indication of approval or decline in real time.

Asynchronous Payments and Transactions

Many payment methods supported by Recurly have asynchronous approval and decline flows, requiring you to listen for status updates when the payment and invoice status is updated.

Subscription lifecycle events

Subscriptions can experience mid-cycle events depending on the payment method, consumer interaction, and other events such as dunning and chargebacks.

Invoice and Transaction lifecycle events

Invoices and Transactions are tightly coupled in Recurly's system, and their status will have an effect on one another. Some events, associated with post-authorization events (voids, refunds, etc.) can affect transactions and invoices and will emit events.

Prerequisites & limitations

You will find all webhook documentation under the main Webhooks section under Notifications.