For subscriptions regarding plans and billing, documentation on payment failure is rather very ambiguous.
From the following documentation it is explained as if payment failure is the result of three consecutive failures of attempting to pull funds with 5 day gaps from the subscriber.
https://developer.paypal.com/docs/subscriptions/customize/payment-failure-retry/
It appears to me that the documentation is differentiating failed attempt to pull funds from the subscriber and a payment failure.
As a result I started to associate the word payment failure to billing cycle payment failure.
Therefore, throughout the document I interpreted all the words payment failure as above.
Thus, I did not think that the BILLING.SUBSCRIPTION.PAYMENT_FAILED webhook event would not be recieved for each failed attempt to pull funds from the subscriber.
However, from the documentation on the following show subscription details api,
(https://developer.paypal.com/docs/api/subscriptions/v1/#subscriptions_get!c=200&path=billing_info/la...)
There is a field called last_failed_payment in subsription which value contains a field called next_payment_retry_date.
This made me question my conclusion that BILLING.SUBSCRIPTION.PAYMENT_FAILED webhook event will be recieved on each payment attempt failure.
Because, if the value for that field was not meant for failed attempt to pull funds from subscriber, next_billing_date value would be enough.
I hope somebody can clear this out for me by answering the following two questions.
1. Do you get a BILLING.SUBSCRIPTION.PAYMENT_FAILED event for failed attempt to pull funds from subscribers or only when those attempts fail and result in a payment failure?
2. Is the payment_failure_threshold subject to the billing cycle payment failure or the failure of each attempts to pull funds from the subscriber?
