---
title: "Beneficiary defined"
method: POST
path: "/BENEFICIARY_SETUP"
tags: ["Fund management"]
---

# Beneficiary defined

`POST /BENEFICIARY_SETUP` (webhook)

Adyen sends this notification when a [benefactor/beneficiary relationship is created](https://docs.adyen.com/api-explorer/#/Fund/latest/post/transferFunds).

## Payload

- BeneficiarySetupNotification
  - `content` BeneficiarySetupNotificationContent
    - `destinationAccountCode` string — The code of the beneficiary account.
    - `destinationAccountHolderCode` string — The code of the beneficiary Account Holder.
    - `merchantReference` string — The reference provided by the merchant.
    - `sourceAccountCode` string — The code of the benefactor account.
    - `sourceAccountHolderCode` string — The code of the benefactor Account Holder.
    - `transferDate` string, date-time — The date on which the beneficiary was set up and funds transferred from benefactor to beneficiary.
    - `transferredTransactionCount` integer — The number of transactions transferred upon the setup of the beneficiary.
  - `eventType` string, required — The event type of the notification.
  - `executingUserKey` string, required — The user or process that has triggered the notification.
  - `live` boolean, required — Indicates whether the notification originated from the live environment or the test environment. If true, the notification originated from the live environment. If false, the notification originated from the test environment.
  - `pspReference` string, required — The PSP reference of the request from which the notification originates.

## Acknowledgement `200`

OK - the request has succeeded.

- NotificationResponse
  - `notificationResponse` string — Set this parameter to **[accepted]** to acknowledge that you received a notification from Adyen.

---

[API](https://skmtc.net/adyen/apis/marketpaynotificationservice.md) · [All operations](https://skmtc.net/adyen/apis/marketpaynotificationservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/marketpaynotificationservice/revisions/fae4b3da8f9f/schema)