Adyen · JSON Structure

Management Create Company Webhook Request Structure

CreateCompanyWebhookRequest schema from Adyen API

Type: object Properties: 16 Required: 6
PaymentsFinancial ServicesFintech

CreateCompanyWebhookRequest is a JSON Structure definition published by Adyen, describing 16 properties, of which 6 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

acceptsExpiredCertificate acceptsSelfSignedCertificate acceptsUntrustedRootCertificate active additionalSettings communicationFormat description encryptionProtocol filterMerchantAccountType filterMerchantAccounts networkType password populateSoapActionHeader type url username

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-structure/management-create-company-webhook-request-structure.json",
  "description": "CreateCompanyWebhookRequest schema from Adyen API",
  "type": "object",
  "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"
  ],
  "name": "CreateCompanyWebhookRequest"
}