Tenant API - Payment Webhooks (Current)

Modify a webhook definition

This endpoint is used to modify a webhook definition.

patch/v2/webhooks/payments/{id}

Request

  • Base URL: https://sender.api.kivra.com
  • URL: https://sender.api.kivra.com/v2/webhooks/payments/{id}
  • Auth: none declared

Path parameters

idstring uuid required

The ID of the webhook to be modified.

Request body

urlstring url

The URL to which Kivra will try to deliver the webhook payloads. Must not be in a reserved domain, must have at least one IPv4 address and must not have any IPv4 addresses in a reserved range. The URL scheme must be HTTPS.

cid_filterstring

The client key of the party that made the API call to send the invoice the payment was based on to Kivra.

tkey_filterstring

The tenant key of the sender of the invoice the payment was based on.

typesstring[]

A list of the types of payments that the tenant wants to receive webhooks for.

eventsstring[]

A list of the payment lifecycle events that the tenant wants to receive webhooks for.

Response

The new definition of the just-modified webhook.

idstring uuid

The ID of the current webhook definition.

urlstring url

The target URL that Kivra will try to deliver to. The hostname in the URL must not be in a restricted domain (like for example example.org or local). The hostname also must resolve to at least one IPv4 address, and must not resolve to any addresses in an IPv4 range reserved by IANA.

cid_filterstring

The client key filter for this webhook configuration.

tkey_filterstring

The tenant key filter for this webhook cofiguration.

typesstring[]

A list of the types of payments that should trigger webhooks.

eventsstring[]

A list of the payment events that should trigger webhooks. Not all events are meaningful for all payment types.

secretstring base64

The newly created secret after a webhook definition was added or modified. The secret is a 256-bit random number that will be used to sign webhook payloads from Kivra. If a secret already exists when a new one is added (that is, when a webhook definition is modified rather han created), payloads will be signed with both the existing and the new secrets for the next 72 hours. For security reasons, this field will be missing in reponses to API calls that do not result in the creation of a new secret.

created_atstring date-time

The time when this definition was created.

Changes

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