---
title: "Designate a beneficiary account and transfer the benefactor's current balance"
method: POST
path: "/setupBeneficiary"
tags: ["General"]
---

# Designate a beneficiary account and transfer the benefactor's current balance

`POST /setupBeneficiary`

Defines a benefactor and a beneficiary relationship between two accounts. At the time of benefactor/beneficiary setup, the funds in the benefactor account are transferred to the beneficiary account, and any further payments to the benefactor account are automatically sent to the beneficiary account. A series of benefactor/beneficiaries may not exceed four beneficiaries and may not have a cycle in it.

## Request body

- SetupBeneficiaryRequest
  - `destinationAccountCode` string, required — The destination account code.
  - `merchantReference` string — A value that can be supplied at the discretion of the executing user.
  - `sourceAccountCode` string, required — The benefactor account.

## Response `200`

OK - the request has succeeded.

- SetupBeneficiaryResponse
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

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