Adyen · Schema

CreateCompanyWebhookRequest

PaymentsFinancial ServicesFintech

Properties

Name Type Description
acceptsExpiredCertificate boolean Indicates if expired SSL certificates are accepted. Default value: **false**.
acceptsSelfSignedCertificate boolean Indicates if self-signed SSL certificates are accepted. Default value: **false**.
acceptsUntrustedRootCertificate boolean Indicates if untrusted SSL certificates are accepted. Default value: **false**.
active boolean Indicates if the webhook configuration is active. The field must be **true** for us to send webhooks about events related an account.
additionalSettings object 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 mor
communicationFormat string Format or protocol for receiving webhooks. Possible values: * **soap** * **http** * **json**
description string Your description for this webhook configuration.
encryptionProtocol string SSL version to access the public webhook URL specified in the `url` field. Possible values: * **TLSv1.3** * **TLSv1.2** * **HTTP** - Only allowed on Test environment. If not specified, the webhook wil
filterMerchantAccountType string Shows how merchant accounts are filtered when configuring the webhook. Possible values: * **allAccounts** : Includes all merchant accounts, and does not require specifying `filterMerchantAccounts`. *
filterMerchantAccounts array 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`. Required if `filterMerc
networkType string Network type for Terminal API notification webhooks. Possible values: * **public** * **local** Default Value: **public**.
password string Password to access the webhook URL.
populateSoapActionHeader boolean Indicates if the SOAP action header needs to be populated. Default value: **false**. Only applies if `communicationFormat`: **soap**.
type string The type of webhook that is being created. Possible values are: - **standard** - **account-settings-notification** - **banktransfer-notification** - **boletobancario-notification** - **directdebit-not
url string Public URL where webhooks will be sent, for example **https://www.domain.com/webhook-endpoint**.
username string Username to access the webhook URL.
View JSON Schema on GitHub

JSON Schema

adyen-createcompanywebhookrequest-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CreateCompanyWebhookRequest",
  "title": "CreateCompanyWebhookRequest",
  "properties": {
    "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"
    },
    "active": {
      "description": "Indicates if the webhook configuration is active. The field must be **true** for us to send 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/AdditionalSettings"
    },
    "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 filtered when configuring the webhook. \n\nPossible values:\n*  **allAccounts** : Includes all merchant accounts, and does not require specifying `filterMerchantAccounts`.\n*  **includeAccounts** : The webhook is configured for the merchant accounts listed in `filterMerchantAccounts`.\n*  **excludeAccounts** : The webhook is not configured for the merchant accounts listed in `filterMerchantAccounts`.\n\n",
      "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"
    },
    "networkType": {
      "description": "Network type for Terminal API notification webhooks. Possible values:\n* **public**\n* **local**\n\nDefault Value: **public**.",
      "enum": [
        "local",
        "public"
      ],
      "type": "string"
    },
    "password": {
      "description": "Password to access the webhook URL.",
      "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 that is being created. 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- **rreq-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.",
      "maxLength": 255,
      "type": "string"
    }
  },
  "required": [
    "url",
    "active",
    "communicationFormat",
    "type",
    "filterMerchantAccountType",
    "filterMerchantAccounts"
  ],
  "type": "object"
}