---
title: "Beneficiary"
canonical: "https://openfinanceguide.com/en/stet/1.6.3/resources/beneficiary"
edition: "STET PSD2 API 1.6.3.1"
source: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.2-openapi.yaml"
pdf: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.1-part-2-functional-model.pdf"
language: "en"
normative: "The normative text is the English PDF and OpenAPI file published by STET. This Markdown reproduces it for reading; where they differ, the PDF prevails."
license: "CC BY 3.0 FR (https://creativecommons.org/licenses/by/3.0/fr/), STET. Converted to Markdown by Open Finance Guide."
---

# Beneficiary

Type: `object` · Kind: Resources

Specification of a beneficiary

Fields:

- `workspace`, [`Workspace`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/workspace.md)
- `id`, `string` — Id of the beneficiary
  Constraints: pattern `^([a-zA-Z0-9 /\-?:\()\.,']{1,36})$`.
- `isTrusted`, `boolean` — The ASPSP having not implemented the trusted beneficiaries list must not set this flag.
  Otherwise, the ASPSP indicates whether or not the beneficiary was registered by the PSU within the trusted beneficiaries list.
  - true: the beneficiary is actually a trusted beneficiary
  - false: the beneficiary is not a trusted beneficiary
- `creditorAgent`, [`FinancialInstitutionIdentification`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/financial-institution-identification.md)
- `creditor`, [`PartyIdentification`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/party-identification.md), required
- `creditorAccount`, [`AccountIdentification`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/account-identification.md)

## Example

```json
{
  "creditor": {
    "name": "myMerchant",
    "postalAddress": {
      "country": "FR",
      "addressLine": [
        "18 rue de la DSP2",
        "75008 PARIS"
      ]
    },
    "organisationId": {
      "identification": "852126789",
      "schemeName": "SIREN",
      "issuer": "FR"
    }
  },
  "creditorAccount": {
    "iban": "YY64COJH41059545330222956960771321",
    "currency": "EUR"
  }
}
```

## Used by

- `POST /payment-requests/{paymentRequestResourceId}/confirmation` (paymentRequestConfirmationPost)
- `PUT /payment-requests/{paymentRequestResourceId}` (paymentRequestPut)
- `GET /payment-requests/{paymentRequestResourceId}` (paymentRequestsGet)
- `POST /payment-requests` (paymentRequestsPost)
- `GET /payment-requests/{paymentRequestResourceId}/transactions` (paymentRequestTransactionsGet)
- `GET /trusted-beneficiaries` (trustedBeneficiariesGet)