Webhook event names Last updated: July 8, 2026
PayPal supports these webhook events:
The webhooks for authorizing and capturing payments correspond to both supported versions of the Payments API:
Note: PayPal supports only PayPal authorizations.
Event, Trigger, Related method Event Trigger Related method PAYMENT.AUTHORIZATION.CREATEDA payment authorization is created, approved, executed, or a future payment authorization is created. Capture authorized payment PAYMENT.AUTHORIZATION.VOIDEDA payment authorization is voided either due to authorization reaching its 30 day validity period or authorization was manually voided using the Void Authorized Payment API. Show details for authorized payment with response status of voided.PAYMENT.CAPTURE.DECLINEDA payment capture is declined. Capture authorized payment with status of declined.PAYMENT.CAPTURE.COMPLETEDA payment capture completes. Capture authorized payment with response status of completed.PAYMENT.CAPTURE.PENDINGThe state of a payment capture changes to pending. Show details for authorized payment with response status of pending.PAYMENT.CAPTURE.REFUNDEDA merchant refunds a payment capture. Capture authorized payment with response status of refunded.PAYMENT.CAPTURE.REVERSEDPayPal reverses a payment capture. Refund captured payment PAYMENT.REFUND.PENDINGRefund status changes to pending. For example, this occurs when an eCheck-based refund takes a couple of days to process the refund from the merchant's bank account. Refund captured payment PAYMENT.REFUND.FAILEDThis event is triggered when a refund is failed. For example, bank settlement process fails to issue the refund. Refund captured payment
Event, Trigger, Related method Event Trigger Related method PAYMENT.AUTHORIZATION.CREATEDA payment authorization is created, approved, executed, or a future payment authorization is created. Create payment with intent set to authorizePAYMENT.AUTHORIZATION.VOIDEDA payment authorization is voided. Void authorization PAYMENT.CAPTURE.COMPLETEDA payment capture completes. Show captured payment details PAYMENT.CAPTURE.DENIEDA payment capture is denied. Show captured payment details PAYMENT.CAPTURE.PENDINGThe state of a payment capture changes to pending. Show captured payment details PAYMENT.CAPTURE.REFUNDEDA merchant refunds a payment capture. Refund captured payment PAYMENT.CAPTURE.REVERSEDPayPal reverses a payment capture. Refund captured payment PAYMENT.REFUND.PENDINGRefund status changes to pending. For example, this occurs when an eCheck-based refund takes a couple of days to process the refund from the merchant's bank account. Refund captured payment PAYMENT.REFUND.FAILEDThis event is triggered when a refund is failed. For example, bank settlement process fails to issue the refund. Refund captured payment
Note: The PAYOUTSBATCH webhooks do not contain item-related information.
To get item-related information, use the HATEOAS links from the webhooks response.
Event, Trigger, Related method Event Trigger Related method IDENTITY.AUTHORIZATION-CONSENT.REVOKEDA user's consent token is revoked. Not applicable
Event Triggered when Related method PAYMENTS.PAYMENT.CREATEDCheckout payment is created and approved by buyer. Payment details CHECKOUT.ORDER.APPROVEDA buyer approved a checkout order Orders CHECKOUT.CHECKOUT.BUYER-APPROVEDExpress checkout payment is created and approved by buyer. Express Checkout
Event, Trigger, Related method Event Trigger Related method CUSTOMER.DISPUTE.CREATEDA dispute is created. N/A CUSTOMER.DISPUTE.RESOLVEDA dispute is resolved. Settle dispute CUSTOMER.DISPUTE.UPDATEDA dispute is updated. Partially update dispute RISK.DISPUTE.CREATEDA risk dispute is created. The CUSTOMER.DISPUTE.CREATED event type supersedes and deprecates this event type.
Event, Trigger, Related method Event Trigger Related method INVOICING.INVOICE.CANCELLEDA merchant or customer cancels an invoice. Cancel invoice INVOICING.INVOICE.CREATEDAn invoice is created. Create draft invoice INVOICING.INVOICE.PAIDAn invoice is paid, partially paid, or payment is made and is pending. Mark invoice as paid INVOICING.INVOICE.REFUNDEDAn invoice is refunded or partially refunded. Mark invoice as refunded INVOICING.INVOICE.SCHEDULEDAn invoice is scheduled. Schedule invoice INVOICING.INVOICE.UPDATEDAn invoice is updated. Update invoice
Event, Triggered When, Related method Event Triggered When Related method CHECKOUT.ORDER.COMPLETEDSee CHECKOUT.ORDER.COMPLETED CHECKOUT.ORDER.APPROVEDSee CHECKOUT.ORDER.APPROVED CHECKOUT.ORDER.PROCESSEDSee CHECKOUT.ORDER.PROCESSED CUSTOMER.ACCOUNT-LIMITATION.ADDEDA limitation is added for a partner's managed account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.ESCALATEDA limitation is escalated for a partner's managed account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.LIFTEDA limitation is lifted for a partner's managed account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.UPDATEDA limitation is updated for a partner's managed account. Update managed account CUSTOMER.MERCHANT-INTEGRATION.CAPABILITY-UPDATEDPayPal must enable the merchant's account as PPCP for this webhook to work. Create partner referral CUSTOMER.MERCHANT-INTEGRATION.PRODUCT-SUBSCRIPTION-UPDATEDThe products available to the merchant have changed. Create partner referral CUSTOMER.MERCHANT-INTEGRATION.SELLER-ALREADY-INTEGRATEDMerchant onboards again to a partner. Create partner referral CUSTOMER.MERCHANT-INTEGRATION.SELLER-ONBOARDING-INITIATEDPayPal creates a merchant account from the partner's onboarding link. Create partner referral CUSTOMER.MERCHANT-INTEGRATION.SELLER-CONSENT-GRANTEDMerchant grants consents to a partner. Create partner referral CUSTOMER.MERCHANT-INTEGRATION.SELLER-EMAIL-CONFIRMEDMerchant confirms the email and consents are granted. Create partner referral MERCHANT.ONBOARDING.COMPLETEDMerchant completes setup. See MERCHANT.ONBOARDING.COMPLETED in Merchant onboarding MERCHANT.PARTNER-CONSENT.REVOKEDThe consents for a merchant account setup are revoked or an account is closed. See MERCHANT.PARTNER-CONSENT.REVOKED in Merchant onboarding PAYMENT.CAPTURE.COMPLETEDA payment capture completes. See PAYMENT.CAPTURE.COMPLETED in Payments PAYMENT.CAPTURE.DENIEDA payment capture is denied. See PAYMENT.CAPTURE.DENIED in Payments PAYMENT.CAPTURE.REFUNDEDA merchant refunds a payment capture. See PAYMENT.CAPTURE.REFUNDED in Payments PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETEDFunds are disbursed to the seller and partner. See PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETE in Payments PAYMENT.REFERENCED-PAYOUT-ITEM.FAILEDAttempt to disburse funds fails. See PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED in Payments
Event, Trigger, Related method Event Trigger Related method MERCHANT.ONBOARDING.COMPLETEDA merchant completes setup. Seller Onboarding MERCHANT.PARTNER-CONSENT.REVOKEDThe consents for a merchant account setup are revoked or an account is closed. Seller Onboarding CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATEDManaged account has been created. Managed Path Onboarding CUSTOMER.MANAGED-ACCOUNT.CREATION-FAILEDManaged account creation failed. Managed Path Onboarding CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATEDManaged account has been updated. Managed Path Onboarding CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGEDCapabilities and/or process status has been changed on a managed account. Managed Path Onboarding CUSTOMER.MANAGED-ACCOUNT.RISK-ASSESSEDManaged account has been risk assessed or the risk assessment has been changed. Managed Path Onboarding CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-NOTIFIEDNegative balance debit has been notified on a managed account. Update managed account CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-DEBIT-INITIATEDNegative balance debit has been initiated on a managed account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.ADDEDA limitation was added for given merchant account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.LIFTEDA limitation was lifted for given merchant account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.UPDATEDA limitation was updated for given merchant account. Update managed account CUSTOMER.ACCOUNT-LIMITATION.ESCALATEDA limitation was escalated for given merchant account. Update managed account
The webhooks for orders correspond to both supported versions of the Orders API:
Event, Trigger, Related method Event Trigger Related method CHECKOUT.ORDER.COMPLETEDA checkout order is processed. Note: For use by marketplaces and platforms only. Orders API CHECKOUT.ORDER.APPROVEDA buyer approved a checkout order Orders API CHECKOUT.PAYMENT-APPROVAL.REVERSEDA problem occurred after the buyer approved the order but before you captured the payment. Refer to Handle uncaptured payments for what to do when this event occurs. Orders API
Event, Trigger, Related method Event Trigger Related method PAYMENT.ORDER.CANCELLEDA payment order is canceled. Void order PAYMENT.ORDER.CREATEDA payment order is created. Create payment
Event, Trigger, Related method Event Trigger Related method PAYMENT.SALE.COMPLETEDA sale completes. Show sale details PAYMENT.SALE.DENIEDThe state of a sale changes from pending to denied. Show sale details PAYMENT.SALE.PENDINGThe state of a sale changes to pending. Show sale details PAYMENT.SALE.REFUNDEDA merchant refunds a sale. Refund sale PAYMENT.SALE.REVERSEDPayPal reverses a sale. Refund sale
The Payment Method Tokens API saves payment methods to a digital vault so payers don't have to enter details for future transactions. Payers can check out faster or pay without being present after they agree to save a payment method.
Event, Trigger, Payment methods Event Trigger Payment methods VAULT.PAYMENT-TOKEN.CREATEDA payment token is created to save a payment method. Cards and PayPal VAULT.PAYMENT-TOKEN.DELETEDA payment token is deleted. The payer's payment method is no longer saved to the PayPal vault. Cards and PayPal VAULT.PAYMENT-TOKEN.DELETION-INITIATEDA request to delete a payment token has been submitted to the Payment Method Tokens API . PayPal
Event, Trigger, Related method Event Trigger Related method PAYMENT-TOKENIZATION.ENROLLMENT.CREATEDAn enrollment is created. N/A PAYMENT-TOKENIZATION.METADATA.CHANGEDThe Payment tokenization metadata is changed. N/A PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.CREATEDThe Payment tokenization payment credential is created. N/A PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.UPDATEDThe Payment tokenization payment credential is updated. N/A PAYMENT-TOKENIZATION.TOKEN-STATUS.CHANGEDThe Payment tokenization token status is changed. N/A PAYMENT-TOKENIZATION.TRANSACTION.CREATEDThe Payment tokenization transaction is created. N/A