Webhooks

Rotate Webhook

Atomically replace the endpoint signing secret and return the new base64-encoded value. Safepay does not retain the previous secret for a server-managed overlap period. A request already in flight can still carry a signature made with the previous secret.

put/v1/aggregators/{raast-aggregator-id}/webhooks/{webhook-id}/rotate

Request

  • Base URL: https://api.getsafepay.com/raastwire
  • URL: https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/webhooks/{webhook-id}/rotate
  • Auth: API key in header X-SFPY-AGGREGATOR-SECRET-KEY

Path parameters

raast-aggregator-idstring required
Example:agg_2288490a-2176-4de5-b373-0ffb6f8e2e6e

The unique identifier for the aggregator

webhook-idstring required
Example:wh_be2d4ee4-96b0-4104-92b2-95237fd3aa16

The unique identifier for the webhook

Response

This response contains details of a Webhook

api_versionstring

The current version of the API spec

Example response

{
  "api_version": "v1"
}

Changes

No recorded changes to this operation across all 1 revision of this API.