Adyen · JSON Structure

Notification Webhooks Incoming Transfer Notification Data Structure

IncomingTransferNotificationData schema from Adyen API

Type: object Properties: 17 Required: 1
PaymentsFinancial-ServicesFintech

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

Properties

accountHolder amount balanceAccount balancePlatform counterparty creationDate description id modification originalAmount paymentId paymentInstrument platformPayment reference referenceForBeneficiary status valueDate

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/notification-webhooks-incoming-transfer-notification-data-structure.json",
  "description": "IncomingTransferNotificationData schema from Adyen API",
  "properties": {
    "accountHolder": {
      "description": "Contains information about the account holder.",
      "$ref": "#/components/schemas/ResourceReference"
    },
    "amount": {
      "description": "The amount converted to the balance account's currency, in case the original transaction currency is different.\n\n* A _positive_ value means the amount is added to the balance account.\n\n * A _negative_ value means the amount is deducted from the balance account. ",
      "$ref": "#/components/schemas/Amount"
    },
    "balanceAccount": {
      "description": "Contains information about the balance account.",
      "$ref": "#/components/schemas/ResourceReference"
    },
    "balancePlatform": {
      "description": "Unique identifier of the balance platform.",
      "type": "string"
    },
    "counterparty": {
      "description": "Contains information about the other party in the transaction.",
      "$ref": "#/components/schemas/Counterparty"
    },
    "creationDate": {
      "description": "Date and time when the event was triggered, in ISO 8601 extended format. For example, **2020-12-18T10:15:30+01:00**.",
      "type": "datetime"
    },
    "description": {
      "description": "Your description for the transfer. If you send a description longer than 140 characters, the text is truncated.",
      "type": "string"
    },
    "id": {
      "description": "The ID of the resource.",
      "type": "string"
    },
    "modification": {
      "description": "Contains the amount and type of modification that triggered the notification. For example, this object contains the amount of a partial cancellation or partial expired authorisation.",
      "$ref": "#/components/schemas/NotificationModificationData"
    },
    "originalAmount": {
      "description": "The amount in the original currency of the transaction.\n\n* A _positive_ value means the amount is added to the balance account.\n\n * A _negative_ value means the amount is deducted from the balance account. ",
      "$ref": "#/components/schemas/Amount"
    },
    "paymentId": {
      "description": "The ID of the original payment authorisation, refund, or funds transfer request. Use this to trace the original request from the `balancePlatform.payment.created` webhook.",
      "type": "string"
    },
    "paymentInstrument": {
      "description": "Contains information about the payment instrument.",
      "$ref": "#/components/schemas/ResourceReference"
    },
    "platformPayment": {
      "description": "Contains information about the related platform payment.",
      "$ref": "#/components/schemas/PlatformPayment"
    },
    "reference": {
      "description": "An Adyen-generated unique reference for the transfer.",
      "maxLength": 80,
      "type": "string"
    },
    "referenceForBeneficiary": {
      "description": "The reference sent to or received from the counterparty.\n\n* For outgoing funds, this is the [`referenceForBeneficiary`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__resParam_referenceForBeneficiary) from the  [`/transfers`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers) request.\n\n * For incoming funds, this is the reference from the sender.",
      "maxLength": 80,
      "type": "string"
    },
    "status": {
      "description": "The event status. The possible values depend on the `type`.\n\n* **Authorised**, **Refused**, or **Error** for type `balancePlatform.payment.created`\n\n * **Expired** or **Cancelled** for type `balancePlatform.payment.updated`\n\n* **PendingIncomingTransfer** for type `balancePlatform.incomingTransfer.created` \n\n* **Refunded** or **IncomingTransfer** for type `balancePlatform.incomingTransfer.updated`\n\n * **Captured** or **OutgoingTransfer** for type `balancePlatform.outgoingTransfer.created`\n\n* **TransferConfirmed**, **TransferSentOut**, or **TransferFailed** for type `balancePlatform.outgoingTransfer.updated`\n\n  ",
      "type": "string"
    },
    "valueDate": {
      "description": "Indicates the expected settlement date of this transaction, in ISO 8601 extended format. For example, **2021-08-17T15:34:37+02:00**.",
      "type": "datetime"
    }
  },
  "required": [
    "counterparty"
  ],
  "type": "object",
  "name": "IncomingTransferNotificationData"
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/notification-webhooks-incoming-transfer-notification-data-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.