Source type

PayPal Source Configuration

PayPal sources receive payment and checkout webhook events and verify PayPal's RSA transmission signature against the configured webhook id.

PAYPALPOST, PUT, PATCH, DELETEWebhook IDPayments
PayPal webhooks documentationAll source types
PayPal sends webhook traffic to a FastHook source, FastHook validates the provider contract, records the request, and routes accepted events through connections to destinations.PayPalProviderPOST, PUT, PATCH, DELETESignedFastHookSource URLPAYPALProvider credentialpublic keyVerify before queue401 on auth failure405 on wrong methodAcceptedRequestverified: trueConnections route the accepted request to destinationsFilters, transformations, retries, replay, and destination signatures stay downstream from source verification.

PayPal configuration

Create a PayPal source, keep POST and PUT and PATCH and DELETE enabled, and provide the configured Webhook ID values for provider signature. FastHook uses these settings to validate each PayPal delivery before it enters the routing workflow.

Source Type

PAYPAL

Allowed methods

POST, PUT, PATCH, DELETE

Authentication

Provider signature

Credential fields

Webhook ID

PayPal source config
{
  "type": "PAYPAL",
  "config": {
    "auth_type": "PROVIDER_SIGNATURE",
    "auth": {
      "provider": "PAYPAL",
      "webhook_id": "WH-..."
    },
    "allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
  }
}

PayPal request contract

FastHook verifies the PayPal RSA signature over transmission id, time, webhook id, and CRC32 of the raw body.

POSTPUTPATCHDELETE

PayPal headers

Preserve paypal-transmission-id, paypal-transmission-time, paypal-transmission-sig, paypal-cert-url, paypal-auth-algo when sending PayPal test deliveries. FastHook evaluates this request context before accepting the payload, so missing or modified values remain visible as rejected requests instead of routed events.

paypal-transmission-id

Transmission id included in the signed payload.

paypal-transmission-time

Transmission time included in the signed payload.

paypal-transmission-sig

Base64 RSA signature.

paypal-cert-url

PayPal certificate URL used for public key lookup.

paypal-auth-algo

Must be SHA256withRSA.

PayPal setup

  1. Create a PayPal webhook endpoint with the generated FastHook Source URL.
  2. Copy the PayPal webhook id into FastHook.
  3. Keep sandbox and production PayPal sources separate.

Continue with PayPal