Source type

GoCardless Source Configuration

GoCardless sources receive payment, mandate, subscription, payout, and customer event webhooks with endpoint-secret verification.

GOCARDLESSPOST, PUT, PATCH, DELETEWebhook Endpoint SecretPayments
GoCardless webhooks documentationAll source types
GoCardless sends webhook traffic to a FastHook source, FastHook validates the provider contract, records the request, and routes accepted events through connections to destinations.GoCardlessProviderPOST, PUT, PATCH, DELETESignedFastHookSource URLGOCARDLESSProvider credentialsignatureVerify 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.

GoCardless configuration

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

Source Type

GOCARDLESS

Allowed methods

POST, PUT, PATCH, DELETE

Authentication

Provider signature

Credential fields

Webhook Endpoint Secret

GoCardless source config
{
  "type": "GOCARDLESS",
  "config": {
    "auth_type": "PROVIDER_SIGNATURE",
    "auth": {
      "provider": "GOCARDLESS",
      "webhook_signing_secret": "webhook-endpoint-secret"
    },
    "allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
  }
}

GoCardless request contract

FastHook computes HMAC-SHA256 hex over the raw body with the webhook endpoint secret and compares it with webhook-signature.

POSTPUTPATCHDELETE

GoCardless headers

Preserve webhook-signature when sending GoCardless 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.

webhook-signature

HMAC-SHA256 hex signature over the raw request body.

GoCardless setup

  1. Create a GoCardless webhook endpoint with the generated FastHook Source URL.
  2. Copy the webhook endpoint secret into FastHook.
  3. Route by resource_type and action fields for mandate, payment, and subscription workflows.

Continue with GoCardless