{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/user-interface/beneficiaries/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Beneficiaries

\n

The beneficiary management feature allows you to add, edit, or delete payment beneficiaries using the Ripple Payments UI.

\n
Note:

This topic describes how you can manage beneficiary identities. For more information on how to manage originator identities, see Originator management.

\n

\"Beneficiaries\"

\n\n

Add a beneficiary identity

\n

To add a beneficiary identity:

\n
    \n
  1. \nFrom the left side navigation, select \nBeneficiaries\n > \nAdd Beneficiary\n.\n
    2. \n
  2. \nSelect whether the beneficiary identity you want to create is for a \nBusiness\n or \nPerson\n (Individual).\n
    3. \n
  3. \nFrom the \nDestination Country\n dropdown list, select the country where your beneficiary will receive the payment.\n
    \nFor an overview of all supported payout countries and currencies, see \nPayout network\n.\n\n
    Note:

    Bank account is currently the only supported payout category.

    \n
    4. \n
  4. \nSelect \nNext\n.\n
    5. \n
  5. \nFill in all fields related to \nidentity details\n and then select \nNext\n.\n
    Note:

    When you specify the beneficiary name, make sure that it exactly matches the legal name that's registered with their bank. For example, if the beneficiary's name is registered with their bank as Dì nà in Pinyin (Chinese Phonetic Alphabet) characters, specifying Tina (in English) in the beneficiary identity field will cause the payment to fail during payout. In this example, you must specify the beneficiary name as Di na, without special characters (ì becomes i and à becomes a), so that it matches their legal name as registered with their bank.

    \n
    6. \n
  6. \nFill in all fields related to \nbank information\n.\n
    Note:

    A beneficiary identity can only be associated with one payout method.

    \n
    7. \n
  7. \nSelect \nFinish\n.\n
    \nThis creates the new beneficiary identity.\n
    8. \n
  8. \nTo confirm that the new beneficiary identity is available for selection when you create a new payment, view the list of identities by selecting \nBeneficiaries\n.\n
    9. \n
\n\n

View beneficiary details

\n

To view beneficiary identity details:

\n
    \n
  1. \nFrom the left side navigation, select \nBeneficiaries\n.\n
    2. \n
  2. \nLocate and select the beneficiary identity for which you want to see details.\n
    3. \n
\n

The beneficiary details will be displayed on the right side.

\n

Edit beneficiary

\n

To edit a beneficiary identity:

\n
    \n
  1. \nFrom the left side navigation, select \nBeneficiaries\n.\n
    2. \n
  2. \nLocate and select the beneficiary identity you want to edit.\n
    3. \n
  3. \nIn the panel on the right side, next to 'Identity Details' or 'Bank Information', select the pencil icon.\n
    4. \n
  4. \nChange all info as needed and then select \nSave\n.\n
    5. \n
\n
Note:

Grayed out fields contain the beneficiary identity's core information and can't be edited.

\n

Your beneficiary identity is now updated with the new information you provided.

\n

Delete beneficiary

\n

To delete a beneficiary identity:

\n
    \n
  1. \nSelect \nBeneficiaries\n.\n
    2. \n
  2. \nLocate and select the beneficiary identity you want to delete.\n
    3. \n
  3. \nIn the panel on the right side, select \n...\n > \nDelete\n.\n
    4. \n
  4. \nIn the \nDelete Beneficiary\n window, confirm that you want to delete the beneficiary identity by selecting \nConfirm\n.\n
    5. \n
\n

Your beneficiary identity is now deleted from your identities list and will no longer be available for selection when you create a new payment.

","headings":[{"value":"Beneficiaries","depth":1},{"value":"Add a beneficiary identity","depth":2},{"value":"View beneficiary details","depth":2},{"value":"Edit beneficiary","depth":2},{"value":"Delete beneficiary","depth":2}]},"contentItem":{"data":{"lastModified":"2025-11-13T00:24:58.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":true,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"0b49e07c-f343-575e-9da5-bc1aee51752d__redocly content/user-interface/beneficiaries/","seo":{"title":"Beneficiaries","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"user-interface/beneficiaries.md","pageBaseUrl":"/user-interface/beneficiaries","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Beneficiaries","id":"beneficiaries"},{"depth":2,"value":"Add a beneficiary identity","id":"add-a-beneficiary-identity"},{"depth":2,"value":"View beneficiary details","id":"view-beneficiary-details"},{"depth":2,"value":"Edit beneficiary","id":"edit-beneficiary"},{"depth":2,"value":"Delete beneficiary","id":"delete-beneficiary"}]},"data":{"title":""},"catalogInfo":null,"link":"/user-interface/beneficiaries/","sidebarName":"__root-sidebar__-data-69308394-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}