Lists all the partner's defined payment webhooks.

GET

/v2/webhooks/payments

const url = 'https://sender.api.kivra.com/v2/webhooks/payments';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://sender.api.kivra.com/v2/webhooks/payments

List payment webhook definitions.

Responses

200

List of defined webhooks.

application/json

Array<object>

PaymentWebhookDefinition

A definition used to send webhooks from Kivra to a sender.

object

The ID of the current webhook definition.

string format: uuid

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.

string format: url

cid_filter

The client key filter for this webhook configuration.

string

/^[0-9]{10}[a-f0-9]{32}$/

tkey_filter

The tenant key filter for this webhook cofiguration.

string

/^[0-9]{10}[a-f0-9]{32}$/

types

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

Array<string>

Allowed values: instant bank autogiro

events

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

Array<string>

Allowed values: scheduled settled failed declined

secret

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.

string format: base64

created_at

The time when this definition was created.

string format: date-time

Example

[
  {
    "types": [
      "instant"
    ],
    "events": [
      "scheduled"
    ]
  }
]