We are implementing Payouts on our website, and we are using Webhooks to update each user´s balance and the status of each payout transaction in our own database records.
I have some doubts about Paypal Payouts´ workflow. I need to know how to handle the following event types:
PAYOUTS.ITEM.FAILED. "This payout request has failed, so funds were not deducted from the sender’s account."
Is this a final status or is it possible for a payout item to move from "failed" to some other condition, and, therefore, trigger another webhook?
PAYOUTS.ITEM.DENIED. "This payout request was denied, so funds were not deducted from the sender’s account."
The same as above. Is this a final status or is it possible for a payout item to move from "failed" to some other condition, and, therefore, trigger another webhook?
PAYOUTS.ITEM.RETURNED. "The recipient has not claimed this payout, so the funds have been returned to your account."
Will I receive both webhooks (RETURNED and REFUNDED) for the same payout item?
PAYOUTS.ITEM.ONHOLD. "This payout request is being reviewed and is on hold."
Which are the possible statuses or triggered webhooks for a Payout item after ONHOLD status?
PAYOUTS.ITEM.BLOCKED. "This payout request has been blocked."
Which are the possible statuses of a Payout item after the BLOCKED webhook is received? Do I need to resend the payout later or will it be unblocked on its own later on, and trigger another type of webhook?
PAYOUTS.ITEM.REVERSED. "This payout request was reversed."
What is the difference between the RETURNED and REVERSED statuses? Could you give me an example of when a Payout could be reversed? Does this event get triggered after a payout has been cancelled?
