{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/Webhook",
"title": "Webhook",
"properties": {
"_links": {
"description": "References to resources connected with this webhook.",
"$ref": "#/components/schemas/WebhookLinks"
},
"acceptsExpiredCertificate": {
"description": "Indicates if expired SSL certificates are accepted. Default value: **false**.",
"type": "boolean"
},
"acceptsSelfSignedCertificate": {
"description": "Indicates if self-signed SSL certificates are accepted. Default value: **false**.",
"type": "boolean"
},
"acceptsUntrustedRootCertificate": {
"description": "Indicates if untrusted SSL certificates are accepted. Default value: **false**.",
"type": "boolean"
},
"accountReference": {
"description": "Reference to the account the webook is set on.",
"type": "string"
},
"active": {
"description": "Indicates if the webhook configuration is active. The field must be **true** for you to receive webhooks about events related an account.",
"type": "boolean"
},
"additionalSettings": {
"description": "Additional shopper and transaction information to be included in your [standard notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes). Find out more about the available [additional settings](https://docs.adyen.com/development-resources/webhooks/additional-settings).",
"$ref": "#/components/schemas/AdditionalSettingsResponse"
},
"certificateAlias": {
"description": "The alias of our SSL certificate. When you receive a notification from us, the alias from the HMAC signature will match this alias.",
"type": "string"
},
"communicationFormat": {
"description": "Format or protocol for receiving webhooks. Possible values:\n* **soap**\n* **http**\n* **json** ",
"enum": [
"http",
"json",
"soap"
],
"example": "soap",
"type": "string"
},
"description": {
"description": "Your description for this webhook configuration.",
"type": "string"
},
"encryptionProtocol": {
"x-addedInVersion": "2",
"description": "SSL version to access the public webhook URL specified in the `url` field. Possible values:\n* **TLSv1.3**\n* **TLSv1.2**\n* **HTTP** - Only allowed on Test environment.\n\nIf not specified, the webhook will use `sslVersion`: **TLSv1.2**.",
"enum": [
"HTTP",
"TLSv1.2",
"TLSv1.3"
],
"example": "TLSv1.2",
"type": "string"
},
"filterMerchantAccountType": {
"description": "Shows how merchant accounts are included in company-level webhooks. Possible values:\n* **includeAccounts**\n* **excludeAccounts**\n* **allAccounts**: Includes all merchant accounts, and does not require specifying `filterMerchantAccounts`.",
"enum": [
"allAccounts",
"excludeAccounts",
"includeAccounts"
],
"type": "string"
},
"filterMerchantAccounts": {
"description": "A list of merchant account names that are included or excluded from receiving the webhook. Inclusion or exclusion is based on the value defined for `filterMerchantAccountType`.\n\nRequired if `filterMerchantAccountType` is either:\n* **includeAccounts**\n* **excludeAccounts**\n\nNot needed for `filterMerchantAccountType`: **allAccounts**.",
"items": {
"type": "string"
},
"type": "array"
},
"hasError": {
"description": "Indicates if the webhook configuration has errors that need troubleshooting. If the value is **true**, troubleshoot the configuration using the [testing endpoint](https://docs.adyen.com/api-explorer/#/ManagementService/v1/post/companies/{companyId}/webhooks/{webhookid}/test).",
"type": "boolean"
},
"hasPassword": {
"description": "Indicates if the webhook is password protected.",
"type": "boolean"
},
"hmacKeyCheckValue": {
"description": "The [checksum](https://en.wikipedia.org/wiki/Key_checksum_value) of the HMAC key generated for this webhook. You can use this value to uniquely identify the HMAC key configured for this webhook.",
"type": "string"
},
"id": {
"description": "Unique identifier for this webhook.",
"type": "string"
},
"networkType": {
"description": "Network type for Terminal API details webhooks.",
"enum": [
"local",
"public"
],
"type": "string"
},
"populateSoapActionHeader": {
"description": "Indicates if the SOAP action header needs to be populated. Default value: **false**.\n\nOnly applies if `communicationFormat`: **soap**.",
"type": "boolean"
},
"type": {
"description": "The type of webhook. Possible values are:\n\n- **standard**\n- **account-settings-notification**\n- **banktransfer-notification**\n- **boletobancario-notification**\n- **directdebit-notification**\n- **ach-notification-of-change-notification**\n- **pending-notification**\n- **ideal-notification**\n- **ideal-pending-notification**\n- **report-notification**\n- **terminal-api-notification**\n\nFind out more about [standard notification webhooks](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes) and [other types of notifications](https://docs.adyen.com/development-resources/webhooks/understand-notifications#other-notifications).",
"type": "string"
},
"url": {
"description": "Public URL where webhooks will be sent, for example **https://www.domain.com/webhook-endpoint**.",
"example": "http://www.adyen.com",
"type": "string"
},
"username": {
"description": "Username to access the webhook URL.",
"type": "string"
}
},
"required": [
"type",
"url",
"active",
"communicationFormat"
],
"type": "object"
}