{ "openapi" : "3.1.0", "info" : { "version" : "1", "x-publicVersion" : true, "title" : "Payment webhooks (deprecated)", "description" : "The payment webhooks are deprecated. Use the [accounting webhooks](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/overview) instead.\n\nAdyen sends webhooks to inform your system about the creation of payment resources and money movements in your platform.\n\nYou can use these webhooks to build your implementation. For example, you can use this information to update balances in your own dashboards or to keep track of incoming funds.", "termsOfService" : "https://www.adyen.com/legal/terms-and-conditions", "contact" : { "name" : "Adyen Developer Experience team", "url" : "https://github.com/Adyen/adyen-openapi" } }, "tags" : [ { "name" : "Payment authorisation, refund, or funds transfer initiated" }, { "name" : "Fund movements" } ], "x-staticResponse" : "response.json", "webhooks" : { "balancePlatform.incomingTransfer.created" : { "post" : { "tags" : [ "Fund movements" ], "summary" : "Incoming transfer created", "description" : "Adyen sends this webhook when there are incoming funds due to a refund or a fund transfer. Use the `paymentId` to link to the original refund request or funds transfer request. Check the content of the webhook to differentiate the events.\n\n* For refunds, the webhook includes the payment instrument to which funds will be refunded.\n\n* For incoming fund transfers, the webhook only includes information about the balance account.", "deprecated" : true, "x-deprecatedInVersion" : "1", "x-deprecatedMessage" : "Use [balancePlatform.transfer.created](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created) instead.", "x-addedInVersion" : "1", "operationId" : "post-balancePlatform.incomingTransfer.created", "x-sortIndex" : 3, "x-methodName" : "incomingTransferCreated", "security" : [ { "BasicAuth" : [ ] } ], "requestBody" : { "content" : { "application/json" : { "examples" : { "balancePlatform-incomingTransfer-created" : { "$ref" : "#/components/examples/post-balancePlatform.incomingTransfer.created-balancePlatform-incomingTransfer-created" } }, "schema" : { "$ref" : "#/components/schemas/IncomingTransferNotificationRequest" } } } }, "responses" : { "200" : { "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/BalancePlatformNotificationResponse" } } }, "description" : "OK - the request has succeeded." } } } }, "balancePlatform.incomingTransfer.updated" : { "post" : { "tags" : [ "Fund movements" ], "summary" : "Incoming transfer updated", "description" : "Adyen sends this webhook when funds were added to the balance account. This could be due to a refund or a funds transfer. Use the `data.id` to track the original incoming transfer resource in the `balancePlatform.incomingTransfer.created` webhook.\n\nThe `status` field indicates the event that triggered the webhook. \n\n* For refunds, the `status` is **Refunded**. \n\n* For incoming fund transfers, the `status` is **IncomingTransfer**.", "deprecated" : true, "x-deprecatedInVersion" : "1", "x-deprecatedMessage" : "Use [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) instead.", "x-addedInVersion" : "1", "operationId" : "post-balancePlatform.incomingTransfer.updated", "x-sortIndex" : 4, "x-methodName" : "incomingTransferUpdated", "security" : [ { "BasicAuth" : [ ] } ], "requestBody" : { "content" : { "application/json" : { "examples" : { "balancePlatform-incomingTransfer-updated" : { "$ref" : "#/components/examples/post-balancePlatform.incomingTransfer.updated-balancePlatform-incomingTransfer-updated" } }, "schema" : { "$ref" : "#/components/schemas/IncomingTransferNotificationRequest" } } } }, "responses" : { "200" : { "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/BalancePlatformNotificationResponse" } } }, "description" : "OK - the request has succeeded." } } } }, "balancePlatform.outgoingTransfer.created" : { "post" : { "tags" : [ "Fund movements" ], "summary" : "Outgoing transfer created", "description" : "Adyen sends this webhook when funds were deducted from a balance account due to a capture or a funds transfer. Use the `paymentId` to link to the original payment authorisation or funds transfer request.\n\nThe `status` field indicates the event that triggered the webhook. \n\n* For captures, the `status` will be **Captured**. \n\n* For outgoing fund transfers, the `status` will be **OutgoingTransfer**.", "deprecated" : true, "x-deprecatedInVersion" : "1", "x-deprecatedMessage" : "Use [balancePlatform.transfer.created](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created) instead.", "x-addedInVersion" : "1", "operationId" : "post-balancePlatform.outgoingTransfer.created", "x-sortIndex" : 1, "x-methodName" : "outgoingTransferCreated", "security" : [ { "BasicAuth" : [ ] } ], "requestBody" : { "content" : { "application/json" : { "examples" : { "balancePlatform-outgoingTransfer-created" : { "$ref" : "#/components/examples/post-balancePlatform.outgoingTransfer.created-balancePlatform-outgoingTransfer-created" } }, "schema" : { "$ref" : "#/components/schemas/OutgoingTransferNotificationRequest" } } } }, "responses" : { "200" : { "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/BalancePlatformNotificationResponse" } } }, "description" : "OK - the request has succeeded." } } } }, "balancePlatform.outgoingTransfer.updated" : { "post" : { "tags" : [ "Fund movements" ], "summary" : "Outgoing transfer updated", "description" : "Adyen sends this webhook when there is updated information after funds have been deducted from a balance account. For example, if the fund transfer failed.\n\nUse the `data.id` to track the original outgoing transfer resource from the `balancePlatform.outgoingTransfer.created` webhook.", "deprecated" : true, "x-deprecatedInVersion" : "1", "x-deprecatedMessage" : "Use [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) instead.", "x-addedInVersion" : "1", "operationId" : "post-balancePlatform.outgoingTransfer.updated", "x-sortIndex" : 2, "x-methodName" : "outgoingTransferUpdated", "security" : [ { "BasicAuth" : [ ] } ], "requestBody" : { "content" : { "application/json" : { "examples" : { "balancePlatform-outgoingTransfer-updated" : { "$ref" : "#/components/examples/post-balancePlatform.outgoingTransfer.updated-balancePlatform-outgoingTransfer-updated" } }, "schema" : { "$ref" : "#/components/schemas/OutgoingTransferNotificationRequest" } } } }, "responses" : { "200" : { "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/BalancePlatformNotificationResponse" } } }, "description" : "OK - the request has succeeded." } } } }, "balancePlatform.payment.created" : { "post" : { "tags" : [ "Payment authorisation, refund, or funds transfer initiated" ], "summary" : "Payment authorisation, refund, or funds transfer initiated", "description" : "Adyen sends this webhook when a payment authorisation, a refund, or a funds transfer has been initiated. This webhook only informs your server of requests. For the actual fund movements, you'll get the information from the subsequent outgoing or incoming transfer webhooks.\n\n To differentiate the requests, check the content of the webhook.\n\n* For payments, the webhook contains the authorisation result, information about the processing merchant, and shows a negative amount.\n\n * For refunds, the webhook contains to which payment instrument the funds will be refunded, and shows a positive amount.\n\n* For outgoing or incoming fund transfers, the webhook shows a positive or negative amount depending on the direction of the transfer, and only includes information about the balance account.", "deprecated" : true, "x-deprecatedInVersion" : "1", "x-deprecatedMessage" : "Use [balancePlatform.transfer.created](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.created) instead.", "x-addedInVersion" : "1", "operationId" : "post-balancePlatform.payment.created", "x-sortIndex" : 1, "x-methodName" : "paymentAuthorisationRefundOrFundsTransferInitiated", "security" : [ { "BasicAuth" : [ ] } ], "requestBody" : { "content" : { "application/json" : { "examples" : { "balancePlatform-payment-created-authorized" : { "$ref" : "#/components/examples/post-balancePlatform.payment.created-balancePlatform-payment-created-authorized" }, "balancePlatform-payment-created-funds-transfer" : { "$ref" : "#/components/examples/post-balancePlatform.payment.created-balancePlatform-payment-created-funds-transfer" }, "balancePlatform-payment-created-refund-requested" : { "$ref" : "#/components/examples/post-balancePlatform.payment.created-balancePlatform-payment-created-refund-requested" }, "balancePlatform-payment-created-rejected" : { "$ref" : "#/components/examples/post-balancePlatform.payment.created-balancePlatform-payment-created-rejected" } }, "schema" : { "$ref" : "#/components/schemas/PaymentNotificationRequest" } } } }, "responses" : { "200" : { "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/BalancePlatformNotificationResponse" } } }, "description" : "OK - the request has succeeded." } } } }, "balancePlatform.payment.updated" : { "post" : { "tags" : [ "Payment authorisation, refund, or funds transfer initiated" ], "summary" : "Payment authorisation expired or cancelled", "description" : "Adyen sends this webhook when a payment authorisation has expired or has been cancelled. Use the `data.id` to track the original payment authorisation from the `balancePlatform.payment.created` webhook.", "deprecated" : true, "x-deprecatedInVersion" : "1", "x-deprecatedMessage" : "Use [balancePlatform.transfer.updated](https://docs.adyen.com/api-explorer/transfer-webhooks/latest/post/balancePlatform.transfer.updated) instead.", "x-addedInVersion" : "1", "operationId" : "post-balancePlatform.payment.updated", "x-sortIndex" : 2, "x-methodName" : "paymentAuthorisationExpiredOrCancelled", "security" : [ { "BasicAuth" : [ ] } ], "requestBody" : { "content" : { "application/json" : { "examples" : { "balancePlatform-payment-updated-expired" : { "$ref" : "#/components/examples/post-balancePlatform.payment.updated-balancePlatform-payment-updated-expired" }, "balancePlatform-payment-updated-partially-cancelled" : { "$ref" : "#/components/examples/post-balancePlatform.payment.updated-balancePlatform-payment-updated-partially-cancelled" }, "balancePlatform-payment-updated-partially-expired" : { "$ref" : "#/components/examples/post-balancePlatform.payment.updated-balancePlatform-payment-updated-partially-expired" } }, "schema" : { "$ref" : "#/components/schemas/PaymentNotificationRequest" } } } }, "responses" : { "200" : { "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/BalancePlatformNotificationResponse" } } }, "description" : "OK - the request has succeeded." } } } } }, "components" : { "schemas" : { "Address" : { "additionalProperties" : false, "properties" : { "city" : { "description" : "The name of the city. Maximum length: 3000 characters.", "maxLength" : 3000, "type" : "string" }, "country" : { "description" : "The two-character ISO-3166-1 alpha-2 country code. For example, **US**.\n> If you don't know the country or are not collecting the country from the shopper, provide `country` as `ZZ`.", "type" : "string" }, "houseNumberOrName" : { "description" : "The number or name of the house. Maximum length: 3000 characters.", "maxLength" : 3000, "type" : "string" }, "postalCode" : { "description" : "A maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries.", "type" : "string" }, "stateOrProvince" : { "description" : "The two-character ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada.\n> Required for the US and Canada.", "type" : "string" }, "street" : { "description" : "The name of the street. Maximum length: 3000 characters.\n> The house number should not be included in this field; it should be separately provided via `houseNumberOrName`.", "maxLength" : 3000, "type" : "string" } }, "required" : [ "street", "houseNumberOrName", "city", "postalCode", "country" ], "type" : "object" }, "Amount" : { "additionalProperties" : false, "properties" : { "currency" : { "description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).", "maxLength" : 3, "minLength" : 3, "type" : "string" }, "value" : { "description" : "The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).", "format" : "int64", "type" : "integer" } }, "required" : [ "value", "currency" ], "type" : "object" }, "BalancePlatformNotificationResponse" : { "additionalProperties" : false, "properties" : { "notificationResponse" : { "description" : "Respond with **HTTP 200 OK** and `[accepted]` in the response body to [accept the webhook](https://docs.adyen.com/development-resources/webhooks#accept-notifications).", "type" : "string" } }, "type" : "object" }, "BankAccountInfo" : { "additionalProperties" : false, "properties" : { "address" : { "description" : "The address of the bank account owner.", "$ref" : "#/components/schemas/Address" }, "iban" : { "description" : "The international bank account number as defined in the [ISO-13616](https://www.iso.org/standard/81090.html) standard.", "type" : "string" }, "ownerName" : { "description" : "The name of the bank account owner.", "$ref" : "#/components/schemas/Name" } }, "type" : "object" }, "Counterparty" : { "additionalProperties" : false, "properties" : { "balanceAccountId" : { "description" : "The unique identifier of the [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).", "type" : "string" }, "bankAccount" : { "description" : "Contains information about the bank account.", "$ref" : "#/components/schemas/BankAccountInfo" }, "merchant" : { "description" : "Contains information about the merchant.", "$ref" : "#/components/schemas/MerchantData" }, "transferInstrumentId" : { "description" : "The unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/transferInstruments__resParam_id).", "type" : "string" } }, "type" : "object" }, "IncomingTransferNotificationData" : { "additionalProperties" : false, "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" : "The 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" : "The date and time when the event was triggered, in ISO 8601 extended format. For example, **2020-12-18T10:15:30+01:00**.", "format" : "date-time", "type" : "string" }, "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** or **AuthAdjustmentAuthorised** or **AuthAdjustmentRefused** 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**.", "format" : "date-time", "type" : "string" } }, "type" : "object" }, "IncomingTransferNotificationRequest" : { "additionalProperties" : false, "properties" : { "data" : { "description" : "Contains event details.", "$ref" : "#/components/schemas/IncomingTransferNotificationData" }, "environment" : { "description" : "The environment from which the webhook originated.\n\nPossible values: **test**, **live**.", "type" : "string" }, "type" : { "description" : "Type of webhook.", "enum" : [ "balancePlatform.incomingTransfer.updated", "balancePlatform.incomingTransfer.created" ], "type" : "string" } }, "required" : [ "environment", "type", "data" ], "type" : "object" }, "MerchantData" : { "additionalProperties" : false, "properties" : { "acquirerId" : { "description" : "The unique identifier of the merchant's acquirer.", "type" : "string" }, "mcc" : { "description" : "The merchant category code.", "type" : "string" }, "merchantId" : { "description" : "The merchant identifier.", "type" : "string" }, "nameLocation" : { "description" : "Contains the merchant's name and location.", "$ref" : "#/components/schemas/NameLocation" }, "postalCode" : { "description" : "The merchant postal code.", "type" : "string" } }, "type" : "object" }, "Name" : { "additionalProperties" : false, "properties" : { "firstName" : { "description" : "The first name.", "type" : "string" }, "fullName" : { "description" : "The full name.", "type" : "string" }, "infix" : { "description" : "The infix in the name, if any.", "type" : "string" }, "lastName" : { "description" : "The last name.", "type" : "string" } }, "type" : "object" }, "NameLocation" : { "additionalProperties" : false, "properties" : { "city" : { "description" : "The city where the merchant is located.", "type" : "string" }, "country" : { "description" : "The country where the merchant is located in [three-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) format.", "type" : "string" }, "countryOfOrigin" : { "description" : "The home country in [three-digit country code](https://en.wikipedia.org/wiki/ISO_3166-1_numeric) format, used for government-controlled merchants such as embassies.", "type" : "string" }, "name" : { "description" : "The name of the merchant's shop or service.", "type" : "string" }, "rawData" : { "description" : "The raw data.", "type" : "string" }, "state" : { "description" : "The state where the merchant is located.", "type" : "string" } }, "type" : "object" }, "NotificationModificationData" : { "additionalProperties" : false, "properties" : { "amount" : { "description" : "The amount of the modification converted to the balance account's currency, in case the original transaction currency is different. For example, if a part of an authorised amount was cancelled, the value shows the amount that was cancelled.\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" }, "type" : { "description" : "The type of modification.\n\nPossible values: **Authorised**, **Cancelled**, **Captured**, **Error**, **Expired**, **OutgoingTransfer**, **PendingIncomingTransfer**, **PendingRefund**, **IncomingTransfer**, **Refunded**, **Refused**, **AuthAdjustmentAuthorised**.", "type" : "string" } }, "type" : "object" }, "OutgoingTransferNotificationData" : { "additionalProperties" : false, "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" : "The 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" : "The date and time when the event was triggered, in ISO 8601 extended format. For example, **2020-12-18T10:15:30+01:00**.", "format" : "date-time", "type" : "string" }, "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" }, "merchantData" : { "description" : "Contains information about the merchant that processed the payment. This object is only included for payment authorisation requests and captures.", "$ref" : "#/components/schemas/MerchantData" }, "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" }, "processingType" : { "description" : "Contains information about how the payment was processed. Possible values: **atmWithdraw**, **balanceInquiry**, **ecommerce**, **moto**, **pos**, **purchaseWithCashback**, **recurring**, **token**, **unknown**.", "enum" : [ "atmWithdraw", "balanceInquiry", "ecommerce", "moto", "pos", "purchaseWithCashback", "recurring", "token", "unknown" ], "type" : "string" }, "purposeCode" : { "description" : "Indicates the purpose of the outgoing transfer. Adyen sets this to:\n\n* **payoutManual** when the transfer was triggered by a one-off payout using the [`/transfers`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers) endpoint.\n\n * **payoutSweep** when the transfer was triggered by a scheduled payout using [`sweepConfigurations`](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_sweepConfigurations).", "type" : "string" }, "reference" : { "description" : "The [`reference`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_reference) from the `/transfers` request. If you haven't provided any, Adyen generates a unique reference.", "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" }, "relayedAuthorisationData" : { "description" : "If you're using [relayed authorisation](https://docs.adyen.com/issuing/processing-payments-for-cards#relayed-authorisation), this object contains information from the relayed authorisation response from your server.", "$ref" : "#/components/schemas/RelayedAuthorisationData" }, "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** or **AuthAdjustmentAuthorised** or **AuthAdjustmentRefused** 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" }, "transactionRulesResult" : { "description" : "Contains results from the evaluation of [transaction rules](https://docs.adyen.com/issuing/transaction-rules).", "$ref" : "#/components/schemas/TransactionRulesResult" }, "valueDate" : { "description" : "Indicates the expected settlement date of this transaction, in ISO 8601 extended format. For example, **2021-08-17T15:34:37+02:00**.", "format" : "date-time", "type" : "string" } }, "required" : [ "counterparty" ], "type" : "object" }, "OutgoingTransferNotificationRequest" : { "additionalProperties" : false, "properties" : { "data" : { "description" : "Contains details about the event.", "$ref" : "#/components/schemas/OutgoingTransferNotificationData" }, "environment" : { "description" : "The environment from which the webhook originated.\n\nPossible values: **test**, **live**.", "type" : "string" }, "type" : { "description" : "Type of webhook.", "enum" : [ "balancePlatform.outgoingTransfer.created", "balancePlatform.outgoingTransfer.updated" ], "type" : "string" } }, "required" : [ "environment", "type", "data" ], "type" : "object" }, "PaymentNotificationData" : { "additionalProperties" : false, "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" }, "authCode" : { "description" : "The authorisation code for the payment.", "type" : "string" }, "balanceAccount" : { "description" : "Contains information about the balance account.", "$ref" : "#/components/schemas/ResourceReference" }, "balancePlatform" : { "description" : "The unique identifier of the balance platform.", "type" : "string" }, "creationDate" : { "description" : "The date and time when the event was triggered, in ISO 8601 extended format. For example, **2020-12-18T10:15:30+01:00**.", "format" : "date-time", "type" : "string" }, "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" }, "merchantData" : { "description" : "Contains information about the merchant that processed the payment. This object is only included for payment authorisation requests and captures.", "$ref" : "#/components/schemas/MerchantData" }, "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" }, "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" }, "processingType" : { "description" : "Contains information about how the payment was processed. Possible values: **atmWithdraw**, **balanceInquiry**, **ecommerce**, **moto**, **pos**, **purchaseWithCashback**, **recurring**, **token**, **unknown**.", "enum" : [ "atmWithdraw", "balanceInquiry", "ecommerce", "moto", "pos", "purchaseWithCashback", "recurring", "token", "unknown" ], "type" : "string" }, "reference" : { "description" : "The [`reference`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_reference) from the `/transfers` request. If you haven't provided any, Adyen generates a unique reference.", "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" }, "relayedAuthorisationData" : { "description" : "If you're using [relayed authorisation](https://docs.adyen.com/issuing/processing-payments-for-cards#relayed-authorisation), this object contains information from the relayed authorisation response from your server.", "$ref" : "#/components/schemas/RelayedAuthorisationData" }, "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** or **AuthAdjustmentAuthorised** or **AuthAdjustmentRefused** 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" }, "transactionRulesResult" : { "description" : "Contains results from the evaluation of [transaction rules](https://docs.adyen.com/issuing/transaction-rules).", "$ref" : "#/components/schemas/TransactionRulesResult" }, "validationResult" : { "description" : "Array of checks that Adyen performed to validate the payment and the result of each.", "items" : { "$ref" : "#/components/schemas/ValidationResult" }, "type" : "array" } }, "type" : "object" }, "PaymentNotificationRequest" : { "additionalProperties" : false, "properties" : { "data" : { "description" : "Contains event details.", "$ref" : "#/components/schemas/PaymentNotificationData" }, "environment" : { "description" : "The environment from which the webhook originated.\n\nPossible values: **test**, **live**.", "type" : "string" }, "type" : { "description" : "Type of webhook.", "enum" : [ "balancePlatform.payment.created", "balancePlatform.payment.updated" ], "type" : "string" } }, "required" : [ "environment", "type", "data" ], "type" : "object" }, "PlatformPayment" : { "additionalProperties" : false, "properties" : { "account" : { "description" : "The account given in the related split.", "type" : "string" }, "description" : { "description" : "The description of the related split.", "type" : "string" }, "modificationMerchantReference" : { "description" : "The merchant reference of the modification.", "type" : "string" }, "modificationPspReference" : { "description" : "The pspReference of the modification.", "type" : "string" }, "paymentMerchantReference" : { "description" : "The merchant reference of the payment.", "type" : "string" }, "paymentPspReference" : { "description" : "The pspReference of the payment.", "type" : "string" }, "reference" : { "description" : "The reference of the related split.", "type" : "string" }, "type" : { "description" : "The type of the related split.", "enum" : [ "AcquiringFees", "AdyenCommission", "AdyenFees", "AdyenMarkup", "BalanceAccount", "Commission", "Default", "Interchange", "PaymentFee", "Remainder", "SchemeFee", "TopUp", "VAT" ], "type" : "string" } }, "type" : "object" }, "RelayedAuthorisationData" : { "additionalProperties" : false, "properties" : { "metadata" : { "additionalProperties" : { "type" : "string" }, "description" : "The `metadata` object from the relayed authorisation response from your server.", "type" : "object" }, "reference" : { "description" : "The `reference` from the relayed authorisation response from your server.", "type" : "string" }, "status" : { "description" : "The value can be **Authorised** or **Refused**, based on the `authorisationDecision.status` in the relayed authorisation response from your server.", "type" : "string" } }, "type" : "object" }, "Resource" : { "additionalProperties" : false, "properties" : { "balancePlatform" : { "description" : "The unique identifier of the balance platform.", "type" : "string" }, "creationDate" : { "description" : "The date and time when the event was triggered, in ISO 8601 extended format. For example, **2020-12-18T10:15:30+01:00**.", "format" : "date-time", "type" : "string" }, "id" : { "description" : "The ID of the resource.", "type" : "string" } }, "type" : "object" }, "ResourceReference" : { "additionalProperties" : false, "properties" : { "description" : { "description" : "The description of the resource.", "type" : "string" }, "id" : { "description" : "The unique identifier of the resource.", "type" : "string" }, "reference" : { "description" : "The reference for the resource.", "type" : "string" } }, "type" : "object" }, "TransactionEventViolation" : { "additionalProperties" : false, "properties" : { "reason" : { "description" : "An explanation about why the transaction rule failed.", "type" : "string" }, "transactionRule" : { "description" : "Contains information about the transaction rule.", "$ref" : "#/components/schemas/TransactionRuleReference" }, "transactionRuleSource" : { "description" : "Contains the type and ID of the resource to which the transaction rule is linked.", "$ref" : "#/components/schemas/TransactionRuleSource" } }, "type" : "object" }, "TransactionNotificationData" : { "additionalProperties" : false, "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" }, "authCode" : { "description" : "The authorisation code for the payment.", "type" : "string" }, "balanceAccount" : { "description" : "Contains information about the balance account.", "$ref" : "#/components/schemas/ResourceReference" }, "balancePlatform" : { "description" : "The 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" : "The date and time when the event was triggered, in ISO 8601 extended format. For example, **2020-12-18T10:15:30+01:00**.", "format" : "date-time", "type" : "string" }, "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" }, "merchantData" : { "description" : "Contains information about the merchant that processed the payment. This object is only included for payment authorisation requests and captures.", "$ref" : "#/components/schemas/MerchantData" }, "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" }, "processingType" : { "description" : "Contains information about how the payment was processed. Possible values: **atmWithdraw**, **balanceInquiry**, **ecommerce**, **moto**, **pos**, **purchaseWithCashback**, **recurring**, **token**, **unknown**.", "enum" : [ "atmWithdraw", "balanceInquiry", "ecommerce", "moto", "pos", "purchaseWithCashback", "recurring", "token", "unknown" ], "type" : "string" }, "purposeCode" : { "description" : "Indicates the purpose of the outgoing transfer. Adyen sets this to:\n\n* **payoutManual** when the transfer was triggered by a one-off payout using the [`/transfers`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers) endpoint.\n\n * **payoutSweep** when the transfer was triggered by a scheduled payout using [`sweepConfigurations`](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_sweepConfigurations).", "type" : "string" }, "reference" : { "description" : "The [`reference`](https://docs.adyen.com/api-explorer/#/transfers/latest/post/transfers__reqParam_reference) from the `/transfers` request. If you haven't provided any, Adyen generates a unique reference.", "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" }, "relayedAuthorisationData" : { "description" : "If you're using [relayed authorisation](https://docs.adyen.com/issuing/processing-payments-for-cards#relayed-authorisation), this object contains information from the relayed authorisation response from your server.", "$ref" : "#/components/schemas/RelayedAuthorisationData" }, "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** or **AuthAdjustmentAuthorised** or **AuthAdjustmentRefused** 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" }, "transactionRulesResult" : { "description" : "Contains results from the evaluation of [transaction rules](https://docs.adyen.com/issuing/transaction-rules).", "$ref" : "#/components/schemas/TransactionRulesResult" }, "validationResult" : { "description" : "Array of checks that Adyen performed to validate the payment and the result of each.", "items" : { "$ref" : "#/components/schemas/ValidationResult" }, "type" : "array" }, "valueDate" : { "description" : "Indicates the expected settlement date of this transaction, in ISO 8601 extended format. For example, **2021-08-17T15:34:37+02:00**.", "format" : "date-time", "type" : "string" } }, "required" : [ "counterparty" ], "type" : "object" }, "TransactionRuleReference" : { "additionalProperties" : false, "properties" : { "description" : { "description" : "The description of the resource.", "type" : "string" }, "id" : { "description" : "The unique identifier of the resource.", "type" : "string" }, "reference" : { "description" : "The reference for the resource.", "type" : "string" } }, "type" : "object" }, "TransactionRuleSource" : { "additionalProperties" : false, "properties" : { "id" : { "description" : "ID of the resource, when applicable.", "type" : "string" }, "type" : { "description" : "Indicates the type of resource for which the transaction rule is defined.\n\nPossible values:\n\n * **PaymentInstrumentGroup**\n\n* **PaymentInstrument**\n\n* **BalancePlatform**\n\n* **EntityUsageConfiguration**\n\n* **PlatformRule**: The transaction rule is a platform-wide rule imposed by Adyen.", "type" : "string" } }, "type" : "object" }, "TransactionRulesResult" : { "additionalProperties" : false, "properties" : { "advice" : { "description" : "The advice given by the Risk analysis.", "type" : "string" }, "allRulesPassed" : { "description" : "Indicates whether the transaction passed the evaluation for all transaction rules.", "type" : "boolean" }, "failedTransactionRules" : { "description" : "Array containing all the transaction rules that the transaction violated. This list is only sent when `allRulesPassed` is **false**.", "items" : { "$ref" : "#/components/schemas/TransactionEventViolation" }, "type" : "array" }, "score" : { "description" : "The score of the Risk analysis.", "format" : "int32", "type" : "integer" } }, "type" : "object" }, "ValidationResult" : { "additionalProperties" : false, "properties" : { "result" : { "description" : "The result of the check.\n\nPossible values:\n\n- **valid**: The validation was successful.\n\n- **invalid**: The validation failed.\n\n- **notValidated**: The validation was not performed because some services were unreachable or Adyen does not have the information needed to perform the check.\n\n- **notApplicable**: The validation is not applicable.", "type" : "string" }, "type" : { "description" : "Type of check.", "type" : "string" } }, "type" : "object" } }, "securitySchemes" : { "BasicAuth" : { "scheme" : "basic", "type" : "http" } }, "examples" : { "post-balancePlatform.incomingTransfer.created-balancePlatform-incomingTransfer-created" : { "summary" : "Pending incoming transfer", "description" : "Example webhook when there is an incoming transfer", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-05-03T15:20:14+02:00", "id" : "IZL6685QQEBKFOOY", "accountHolder" : { "description" : "S. Eller", "id" : "AH32272223222B5BBXP2Z8ZWS" }, "amount" : { "currency" : "EUR", "value" : 15000 }, "balanceAccount" : { "description" : "S. Eller - Main account", "id" : "BA32272223222B5BQ3KWP86MW" }, "modification" : { "amount" : { "currency" : "EUR", "value" : 15000 }, "type" : "PendingIncomingTransfer" }, "originalAmount" : { "currency" : "EUR", "value" : 15000 }, "counterparty" : { "balanceAccountId" : "BA00000000000000000000001" }, "paymentId" : "IZL6685QQEBKFON0", "status" : "PendingIncomingTransfer" }, "environment" : "test", "type" : "balancePlatform.incomingTransfer.created" } }, "post-balancePlatform.incomingTransfer.updated-balancePlatform-incomingTransfer-updated" : { "summary" : "Completed incoming transfer", "description" : "Example webhook when an incoming transfer was completed and funds were settled", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-05-03T15:20:14+02:00", "id" : "IZL6685QQEBKFOOY", "accountHolder" : { "description" : "Liable account holder", "id" : "AH32272223222B5BBXP2Z8ZWS" }, "amount" : { "currency" : "EUR", "value" : 1500 }, "balanceAccount" : { "description" : "second-account", "id" : "BA32272223222B5BQ3KWP86MW" }, "modification" : { "amount" : { "currency" : "EUR", "value" : 1500 }, "type" : "IncomingTransfer" }, "originalAmount" : { "currency" : "EUR", "value" : 1500 }, "counterparty" : { "balanceAccountId" : "BA00000000000000000000001" }, "paymentId" : "IZL6685QQEBKFON0", "status" : "IncomingTransfer" }, "environment" : "test", "type" : "balancePlatform.incomingTransfer.updated" } }, "post-balancePlatform.outgoingTransfer.created-balancePlatform-outgoingTransfer-created" : { "summary" : "Completed outgoing funds transfer", "description" : "Example webhook when an outgoing funds transfer was completed", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-05-03T15:20:06+02:00", "id" : "1W1UG35QQEBJLHZ8", "accountHolder" : { "description" : "S. Eller - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -1500 }, "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "originalAmount" : { "currency" : "EUR", "value" : -1500 }, "modification" : { "amount" : { "currency" : "EUR", "value" : -1500 }, "type" : "OutgoingTransfer" }, "counterparty" : { "balanceAccountId" : "BA00000000000000000000001" }, "paymentId" : "1W1UG35QQEBJLHZ8", "status" : "OutgoingTransfer", "valueDate" : "2021-08-10T14:57:01+02:00" }, "environment" : "test", "type" : "balancePlatform.outgoingTransfer.created" } }, "post-balancePlatform.outgoingTransfer.updated-balancePlatform-outgoingTransfer-updated" : { "summary" : "Outgoing funds transfer failed", "description" : "Example webhook if an outgoing funds transfer failed", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-05-03T15:20:06+02:00", "id" : "1W1UG35QQEBJLHZ8", "accountHolder" : { "description" : "S. Eller - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -1500 }, "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "originalAmount" : { "currency" : "EUR", "value" : -1500 }, "modification" : { "amount" : { "currency" : "EUR", "value" : -1500 }, "type" : "OutgoingTransfer" }, "counterparty" : { "balanceAccountId" : "BA00000000000000000000001" }, "paymentId" : "1W1UG35QQEBJLHZ8", "status" : "TransferFailed", "valueDate" : "2021-08-10T14:57:01+02:00" }, "environment" : "test", "type" : "balancePlatform.outgoingTransfer.updated" } }, "post-balancePlatform.payment.created-balancePlatform-payment-created-authorized" : { "summary" : "Payment authorized", "description" : "Example webhook when a payment made with an Adyen-issued card was authorized", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-04-01T12:56:38+02:00", "id" : "1W1UG35QDNNE694X", "accountHolder" : { "description" : "S. Eller - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -2000 }, "authCode" : "397402", "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "merchantData" : { "mcc" : "7999", "merchantId" : "526567789012346", "nameLocation" : { "city" : "Amsterdam", "country" : "NLD", "name" : "Store-ecom", "rawData" : "Store-ecom Amsterdam NLD" } }, "modification" : { "amount" : { "currency" : "EUR", "value" : -2000 }, "type" : "Authorised" }, "originalAmount" : { "currency" : "EUR", "value" : -2000 }, "paymentInstrument" : { "description" : "C. Holden - card", "id" : "PI32272223222B5CZW7BQ2V3T" }, "processingType" : "ecommerce", "relayedAuthorisationData" : { "metadata" : { "key1" : "value1", "key2" : "value2", "key3" : "value3" } }, "status" : "Authorised", "transactionRulesResult" : { "allRulesPassed" : true }, "validationResult" : [ { "result" : "valid", "type" : "BalanceCheck" }, { "result" : "valid", "type" : "AccountLookup" }, { "result" : "valid", "type" : "RelayedAuthorisation" }, { "result" : "valid", "type" : "Screening" }, { "result" : "valid", "type" : "TransactionRules" }, { "result" : "valid", "type" : "TransactionValidation" }, { "result" : "valid", "type" : "PaymentInstrumentExpirationCheck" }, { "result" : "valid", "type" : "MaxAuthAmount" }, { "result" : "valid", "type" : "CVC2" } ] }, "environment" : "test", "type" : "balancePlatform.payment.created" } }, "post-balancePlatform.payment.created-balancePlatform-payment-created-funds-transfer" : { "summary" : "Outgoing transfer requested", "description" : "Example webhook when an outgoing transfer was requested", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-05-03T15:20:06+02:00", "id" : "1W1UG35QQEBJLHZ8", "accountHolder" : { "description" : "Liable account holder", "id" : "AH32272223222B59MTF7458DP", "reference" : "Liable account holder" }, "amount" : { "currency" : "EUR", "value" : -15000 }, "balanceAccount" : { "description" : "Liable balance account", "id" : "BA3227C223222B5B9SCR82TMV" }, "modification" : { "amount" : { "currency" : "EUR", "value" : -15000 }, "type" : "Authorised" }, "originalAmount" : { "currency" : "EUR", "value" : -15000 }, "status" : "Authorised" }, "environment" : "test", "type" : "balancePlatform.payment.created" } }, "post-balancePlatform.payment.created-balancePlatform-payment-created-refund-requested" : { "summary" : "Refund requested", "description" : "Example webhook when your user requests a refund", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-04-13T13:35:17+02:00", "id" : "IZMP115QIFI1EXZK", "accountHolder" : { "description" : "S. Eller", "id" : "AH32272223222B59MTF7458DP" }, "amount" : { "currency" : "EUR", "value" : 2000 }, "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "originalAmount" : { "currency" : "EUR", "value" : 2000 }, "modification" : { "amount" : { "currency" : "EUR", "value" : 2000 }, "type" : "Authorised" }, "paymentInstrument" : { "description" : "Test card", "id" : "PI3227C223222B5BKTS5RC3D3" }, "status" : "Authorised" }, "environment" : "test", "type" : "balancePlatform.payment.created" } }, "post-balancePlatform.payment.created-balancePlatform-payment-created-rejected" : { "summary" : "Payment declined", "description" : "Example webhook when a payment made with an Adyen-issued card was declined", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-03-15T10:30:43+01:00", "id" : "2L470J5Q6VVUAWGT", "accountHolder" : { "description" : "S. Eller - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -1000 }, "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "merchantData" : { "mcc" : "7999", "merchantId" : "526567789012346", "nameLocation" : { "city" : "Amsterdam", "country" : "NLD", "name" : "Store-ecom", "rawData" : "Store-ecom Amsterdam NLD" } }, "modification" : { "amount" : { "currency" : "EUR", "value" : -1000 }, "type" : "Refused" }, "originalAmount" : { "currency" : "EUR", "value" : -1000 }, "paymentInstrument" : { "description" : "C. Holden - card", "id" : "PI32272223222B5CZW7BQ2V3T" }, "processingType" : "ecommerce", "status" : "Refused", "transactionRulesResult" : { "allRulesPassed" : false, "failedTransactionRules" : [ { "reason" : "This event exceeds the maximum allowed number of transactions (1) in interval monthly", "transactionRule" : { "description" : "Allow 1 transactions per month", "id" : "TR32272223222B5CSZ666CTKF", "reference" : "myRule12345" }, "transactionRuleSource" : { "id" : "PI3227C223222B5BKTS5RC3D3", "type" : "PaymentInstrument" } } ] }, "validationResult" : [ { "result" : "valid", "type" : "MaxAuthAmount" }, { "result" : "valid", "type" : "CVC2" }, { "result" : "valid", "type" : "BalanceCheck" }, { "result" : "valid", "type" : "AccountLookup" }, { "result" : "invalid", "type" : "TransactionRules" }, { "result" : "valid", "type" : "TransactionValidation" }, { "result" : "notApplicable", "type" : "RelayedAuthorisation" }, { "result" : "valid", "type" : "PaymentInstrumentExpirationCheck" }, { "result" : "valid", "type" : "Screening" } ] }, "environment" : "test", "type" : "balancePlatform.payment.created" } }, "post-balancePlatform.payment.updated-balancePlatform-payment-updated-expired" : { "summary" : "Payment authorization expired", "description" : "Example webhook when a payment authorization expired", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-03-25T11:42:05+01:00", "id" : "2L470J5QAVHDDZTW", "accountHolder" : { "description" : "S.Hopper - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -2500 }, "authCode" : "995167", "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "merchantData" : { "mcc" : "7999", "merchantId" : "526567789012346", "nameLocation" : { "city" : "Amsterdam", "country" : "NLD", "name" : "Store-ecom", "rawData" : "Store-ecom Amsterdam NLD" } }, "modification" : { "amount" : { "currency" : "EUR", "value" : 2500 }, "type" : "Expired" }, "originalAmount" : { "currency" : "EUR", "value" : -2500 }, "paymentInstrument" : { "description" : "S.Hopper - card", "id" : "PI32272223222B5CZW7BQ2V3T" }, "processingType" : "ecommerce", "relayedAuthorisationData" : { "metadata" : { "key1" : "value1", "key2" : "value2", "key3" : "value3" } }, "status" : "Expired", "transactionRulesResult" : { "allRulesPassed" : true }, "validationResult" : [ { "result" : "valid", "type" : "AccountLookup" }, { "result" : "valid", "type" : "PaymentInstrumentExpirationCheck" }, { "result" : "valid", "type" : "Screening" }, { "result" : "valid", "type" : "TransactionValidation" }, { "result" : "valid", "type" : "RelayedAuthorisation" }, { "result" : "valid", "type" : "BalanceCheck" }, { "result" : "valid", "type" : "CVC2" }, { "result" : "valid", "type" : "MaxAuthAmount" }, { "result" : "valid", "type" : "TransactionRules" } ] }, "environment" : "test", "type" : "balancePlatform.payment.updated" } }, "post-balancePlatform.payment.updated-balancePlatform-payment-updated-partially-cancelled" : { "summary" : "Part of payment authorization cancelled", "description" : "Example webhook when a part of the authorization was cancelled", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-03-25T11:42:05+01:00", "id" : "2L470J5QAVHDDZTW", "accountHolder" : { "description" : "S.Hopper - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -2500 }, "authCode" : "995167", "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "merchantData" : { "mcc" : "7999", "merchantId" : "526567789012346", "nameLocation" : { "city" : "Amsterdam", "country" : "NLD", "name" : "Store-ecom", "rawData" : "Store-ecom Amsterdam NLD" } }, "modification" : { "amount" : { "currency" : "EUR", "value" : 1200 }, "type" : "Expired" }, "originalAmount" : { "currency" : "EUR", "value" : -2500 }, "paymentInstrument" : { "description" : "S.Hopper - card", "id" : "PI32272223222B5CZW7BQ2V3T" }, "processingType" : "ecommerce", "relayedAuthorisationData" : { "metadata" : { "key1" : "value1", "key2" : "value2", "key3" : "value3" } }, "status" : "Expired", "transactionRulesResult" : { "allRulesPassed" : true }, "validationResult" : [ { "result" : "valid", "type" : "AccountLookup" }, { "result" : "valid", "type" : "PaymentInstrumentExpirationCheck" }, { "result" : "valid", "type" : "Screening" }, { "result" : "valid", "type" : "TransactionValidation" }, { "result" : "valid", "type" : "RelayedAuthorisation" }, { "result" : "valid", "type" : "BalanceCheck" }, { "result" : "valid", "type" : "CVC2" }, { "result" : "valid", "type" : "MaxAuthAmount" }, { "result" : "valid", "type" : "TransactionRules" } ] }, "environment" : "test", "type" : "balancePlatform.payment.updated" } }, "post-balancePlatform.payment.updated-balancePlatform-payment-updated-partially-expired" : { "summary" : "Part of payment authorization expired", "description" : "Example webhook when a part of the authorization expired", "value" : { "data" : { "balancePlatform" : "YOUR_BALANCE_PLATFORM", "creationDate" : "2021-03-25T11:42:05+01:00", "id" : "2L470J5QAVHDDZTW", "accountHolder" : { "description" : "S.Hopper - Staff 123", "id" : "AH32272223222B5CZW6QZ2V34" }, "amount" : { "currency" : "EUR", "value" : -2500 }, "authCode" : "995167", "balanceAccount" : { "description" : "My Balance Account", "id" : "BA3227C223222B5B9SCR82TMV" }, "merchantData" : { "mcc" : "7999", "merchantId" : "526567789012346", "nameLocation" : { "city" : "Amsterdam", "country" : "NLD", "name" : "Store-ecom", "rawData" : "Store-ecom Amsterdam NLD" } }, "modification" : { "amount" : { "currency" : "EUR", "value" : 1200 }, "type" : "Expired" }, "originalAmount" : { "currency" : "EUR", "value" : -2500 }, "paymentInstrument" : { "description" : "S.Hopper - card", "id" : "PI32272223222B5CZW7BQ2V3T" }, "processingType" : "ecommerce", "relayedAuthorisationData" : { "metadata" : { "key1" : "value1", "key2" : "value2", "key3" : "value3" } }, "status" : "Expired", "transactionRulesResult" : { "allRulesPassed" : true }, "validationResult" : [ { "result" : "valid", "type" : "AccountLookup" }, { "result" : "valid", "type" : "PaymentInstrumentExpirationCheck" }, { "result" : "valid", "type" : "Screening" }, { "result" : "valid", "type" : "TransactionValidation" }, { "result" : "valid", "type" : "RelayedAuthorisation" }, { "result" : "valid", "type" : "BalanceCheck" }, { "result" : "valid", "type" : "CVC2" }, { "result" : "valid", "type" : "MaxAuthAmount" }, { "result" : "valid", "type" : "TransactionRules" } ] }, "environment" : "test", "type" : "balancePlatform.payment.updated" } } } } }