--- title: "Payout descriptions" description: "Learn how you can customize payout descriptions that appear on your users' bank statements." url: "https://docs.adyen.com/marketplaces/payout-descriptions" source_url: "https://docs.adyen.com/marketplaces/payout-descriptions.md" canonical: "https://docs.adyen.com/marketplaces/payout-descriptions" last_modified: "2026-05-19T18:02:48+02:00" language: "en" --- # Payout descriptions Learn how you can customize payout descriptions that appear on your users' bank statements. [View source](/marketplaces/payout-descriptions.md) You can control the information that beneficiaries see on their bank statements when receiving transfers. This page explains how payout descriptors passed through the Adyen to the beneficiary's bank, and the customization options available for different payout products. ## How payout descriptions work When you initiate a transfer or configure a payout schedule, you can provide information in two primary fields: `description` and `referenceForBeneficiary`. These fields follow a multi-step journey through Adyen's system and the wider financial network: 1. **Submission**: You send the description and reference information using the Transfer API or Customer Area. 2. **Transmission and processing**: Adyen transmits the data through the financial network to the clearing system. The clearing system then processes this information and passes the description and reference details to the beneficiary's bank, based on the specific capabilities and character limits of that network. 3. **Beneficiary statement**: The beneficiary bank receives the information and determines how much of it to display on the your user's bank statement. ## Payout descriptor components A complete payout descriptor typically consists of the following: * **Originator name**: The name of the party instructing the transfer (for example, "sender name" or "debtor name"). At Adyen, this is either the name of Adyen's legal entity or your marketplace's legal entity, depending on the region. If the name your marketplace's legal entity is used, you can modify it by providing a **Doing Business As** name on the hosted onboarding page or by making a [Legal Entity Management API](https://docs.adyen.com/api-explorer/legalentity/latest/overview) request. In this case, you must reach out to your Adyen contact to set the new name as the originator name. * **Remittance information**: Free-text fields, including the `description` and `referenceForBeneficiary`. * **Unique identifiers**: Alpha-numeric and numeric identifiers used by banks and clearing systems to reconcile the transactions. ## Scheduled payouts For automated payouts (managed or custom), you can use static text or dynamic placeholders to ensure every scheduled transfer is recognizable to your user. ### Description placeholders Placeholders allow you to automatically reflect specific references in all scheduled payouts. You can use these in the `description` or `referenceForBeneficiary` fields of a managed or custom payout schedule, or can be set up for your entire balance platform by your Adyen contact. To dynamically change the transfer descriptions, set any of the following placeholders in the `description` and/or `referenceForBeneficiary` fields: | Placeholder | Description | Example value in the statement | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | `$balanceAccountId` | The ID of the balance account. | BA00000000000000000000001 | | `$balanceAccountReference` | Your reference for the balance account. | BA reference | | `$balanceAccountDescription` | Your description for the balance account. | BA description | | `$accountHolderId` | The ID of the account holder. | AH00000000000000000000001 | | `$accountHolderReference` | Your reference of the account holder. | AH reference | | `$accountHolderDescription` | Your description for the account holder. | Dean's Donuts | | `$transferReference` | * [Managed payouts](/marketplaces/managed-payouts): The 15-character Adyen-generated reference for the resulting transfer. * [Custom scheduled payouts](/marketplaces/custom-payouts/scheduled-payouts): The 30-character Adyen-generated reference for the resulting transfer. | - SP0000000000001 - SWPE12345678901234567890123456 | | `$shortTransferReference` | Only for [custom scheduled payouts](/marketplaces/custom-payouts/scheduled-payouts): The 15-character Adyen-generated reference for the resulting transfer. | S12345678901234 | For example, setting the `description` to `$accountHolderId` and `$accountHolderDescription` when creating a payout schedule generates a transfer request with the description **AH00000000000000000000001** and **Dean's Donuts**. To automate the reconciliation of payouts, we recommend that you use the `$shortTransferReference`. This appears in the: * Customer Area under **Transfer Details** page under **Description** * Transfer confirmation letter under **Description** * [Balance Platform Payout Report](/marketplaces/reports-and-fees/payout-report) under **Description** * Beneficiary bank statements as remittance information. This is provided by all banks, but the location in the bank statement can differ. If you set the `description` or `referenceForBeneficiary` for [custom scheduled payouts](/marketplaces/custom-payouts/scheduled-payouts) both on the balance account and on the balance platform-level, the setting on balance account-level takes precedence. If you haven't configured a descriptor, the default value is **EXT BAL SWEEP SWPE $\[...]$**. ## On-demand payouts and Cashout For manual transfers initiated by using the Transfer API, you must provide the descriptions as static strings within the API request. Placeholders are not supported for these on-demand requests. * **Customization**: You can populate the `description` and `referenceForBeneficiary` parameters directly in each [/transfers](https://docs.adyen.com/api-explorer/transfers/latest/post/transfers) and `/cashouts` request. * **Reconciliation**: Since these payouts are not automated based on a pre-configured schedule, we recommended that you include unique internal references in the `description` field to assist your users with reconciliation. ## Transfer statement description character limits The following limits apply to the length and the characters that you can use when setting a transfer statement description based on the location of the counterparty and the priority. ### Character limits The following tables show the character limits for each combination of currency and priority that Adyen supports. ### Tab: Europe #### Bulgaria | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | BGN | regular | `description` | \[A-Z] \[a-z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 35 | | | | `referenceForBeneficiary` | \[A-Z] \[a-z] \[0-9] | 80 | 35 | | BGN | wire | `description` | \[A-Z] \[a-z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[A-Z] \[a-z] \[0-9] | 80 | 140 | #### Czech Republic | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | CZK | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | | CZK | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### Denmark | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ------------------------------------------------------- | ---------------------------- | ------------------------------------------ | | DKK | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? ( ) . , = \\! % & \* ; Space | 140 | 70 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 70 | | DKK | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? ( ) . , = \\! % & \* ; Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### Hungary | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | HUF | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 20 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 20 | #### Norway | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ------------------------------------------------------- | ---------------------------- | ------------------------------------------ | | NOK | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? ( ) . , = \\! % & \* ; Space | 140 | 25 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 25 | | NOK | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? ( ) . , = \\! % & \* ; Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### Poland | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ------------------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------- | | PLN | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? ( ) . , = \\! % & \* ; Space | 140 | 0 Adyen accepts a description in the transfer request, but it does not appear in bank statements. | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 0 Adyen accepts a reference for beneficiary in the transfer request, but it does not appear in bank statements. | | PLN | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### Romania | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | RON | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 70 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 70 | | RON | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### Single Euro Payments Area (SEPA) | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | EUR | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 35 | | EUR | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 35 | | EUR | instant | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 0 | #### Sweden | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | SEK | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 11 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 11 | | SEK | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 35 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 35 | #### Switzerland | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------- | | CHF | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 85 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 0 Adyen accepts a reference for beneficiary in the transfer request, but it does not appear in bank statements. | | CHF | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 60 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 0 Adyen accepts a reference for beneficiary in the transfer request, but it does not appear in bank statements. | #### United Kingdom | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ----------------------------------------------------------------------- | ---------------------------- | ------------------------------------------ | | GBP | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + # = \\! " % & \* ; { } @ Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 18 | | GBP | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 16 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 16 | | GBP | fast | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | ### Tab: North America #### Canada | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | CAD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 12 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 12 | | USD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 12 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 12 | #### United States | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | USD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 30 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 15 | | USD | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 16 | | USD | fast | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 30 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 15 | | USD | instant | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 16 | ### Tab: Asia Pacific #### Australia | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | AUD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . ,' + Space | 140 | 18 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 18 | | AUD | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 35 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 35 | | AUD | fast | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 280 (Adyen accepts a maximum of 140) | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 280 (Adyen accepts a maximum of 140) | #### Hong Kong | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | HKD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . ,' + Space | 140 | 18 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 18 | | HKD | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | | USD | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### New Zealand | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | ------------------------------------------ | | NZD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . ,' + Space | 140 | 35 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 35 | | NZD | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | #### Singapore | Currency | Payout priority | API field name | Allowed characters | Maximum number of characters | Number of characters visible on statements | | -------- | --------------- | ------------------------- | ---------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------- | | SGD | regular | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . ,' + Space | 140 | 18 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 18 | | SGD | wire | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 0 Adyen accepts a description in the transfer request, but it does not appear in bank statements. | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 0 Adyen accepts a reference for beneficiary in the transfer request, but it does not appear in bank statements. | | SGD | fast | `description` | \[a-z] \[A-Z] \[0-9] / - ? : ( ) . , ' + Space | 140 | 140 | | | | `referenceForBeneficiary` | \[a-z] \[A-Z] \[0-9] | 80 | 140 | ## See also * [Managed payouts](/marketplaces/managed-payouts) * [Scheduled custom payouts](/marketplaces/custom-payouts/scheduled-payouts) * [On-demand payouts](/marketplaces/custom-payouts/on-demand-payouts) * [Cash out instantly](/marketplaces/cash-out-instantly)