PayPal Checkout

Add Webhooks

Add webhooks to your integration, to listen for the following events:

  • Buyer approval
  • Authorize an order
  • Void an authorization
  • Capture an authorization or an order
  • Refund a capture

First set up a webhooks integration. Then listen for Orders API events using the following event names:

Checkout flow Event name Related API endpoints
Buyer approval CHECKOUT.ORDER.APPROVED n/a
Authorize an order PAYMENT.AUTHORIZATION.CREATED /v2/checkout/orders/{order_id}/authorize
Void an authorization PAYMENT.AUTHORIZATION.VOIDED /v2/payments/authorizations/{authorization_id}/void
Capture an order or authorization PAYMENT.CAPTURE.COMPLETED /v2/checkout/orders/{order_id}/capture
/v2/payments/authorizations/{authorization_id}/capture
PAYMENT.CAPTURE.DENIED /v2/checkout/orders/{order_id}/capture
/v2/payments/authorizations/{authorization_id}/capture
PAYMENT.CAPTURE.PENDING /v2/checkout/orders/{order_id}/capture
/v2/payments/authorizations/{authorization_id}/capture
Refund a capture PAYMENT.CAPTURE.REFUNDED /v2/payments/captures/{capture_id}/refund
Feedback