Today these signals come from Mastercard only, so coverage is limited to Mastercard cards. Nothing in the API is Mastercard-specific except the field names.
When a Signal Arrives
A signal is raised for a recurring card payment that was declined for insufficient funds. Both conditions have to hold—a customer-present checkout decline or any other decline reason produces nothing. A signal is a suggestion, not an instruction. PayNext decides what to do with it based on the state of the subscription at that moment:Read the Outcome on a Payment
payment_details carries the signal on both sides of a recovery: the declined payment that was signalled, and the charge that signal created.
On the declined payment:
On the retry payment:
See It in the Dashboard
Open a payment in Dashboard → Payments. The timeline shows when a signal arrived and what was decided, and a retry payment names the declined payment it came from. Under More filters → Mastercard Payment Alerts:- Payment Alert Received — payments a signal arrived for
- POP Retry Payment — payments created by a signal
- POP Outcome — what each signal led to, including the reason for a skip