{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/products/payments-direct-2/user-interface/guides/manage-beneficiaries","default":true,"active":true,"folderId":"eb16255d"},{"version":"v2026.03","label":"v2026.03","link":"/products/payments-direct-2/v2026.03/user-interface/guides/manage-beneficiaries","default":false,"active":false,"folderId":"eb16255d"},{"version":"v2025.11","label":"v2025.11","link":"/products/payments-direct-2/v2025.11/user-interface/guides/manage-beneficiaries","default":false,"active":false,"folderId":"eb16255d"}],"sharedDataIds":{"sidebar":"sidebar-products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Manage beneficiaries","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-beneficiaries","__idx":0},"children":["Manage beneficiaries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this guide to create, view, edit, and delete beneficiary profiles in the ","Payments Direct"," interface. Beneficiaries are the payment recipients selected when you create a payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the API, beneficiaries are represented as ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments-direct-2/introduction/concepts/payment-identities"},"children":["payment identities"]}," and their associated ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments-direct-2/introduction/concepts/financial-instruments"},"children":["financial instruments"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must have access to the ","Payments Direct UI","."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The destination country and currency must be supported. For a list of supported corridors, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/payments-direct-2/introduction/payout-network"},"children":["Payout network"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-a-beneficiary","__idx":2},"children":["Add a beneficiary"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the left navigation, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiaries"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Beneficiary"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select whether the beneficiary is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Person"]}," (Individual)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Destination Country"]}," dropdown, select the country where the beneficiary will receive the payment."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete all required fields in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity details"]}," step."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Match bank records exactly"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Beneficiary identity details must match the beneficiary's bank records. Mismatches can cause rejections, returns, or recalls. These are sometimes reported as \"Invalid account\" even when the account format is correct."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the legal name exactly as it appears in the beneficiary's bank records."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify details using a recent bank statement or official bank letter."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use only the character set supported by the corridor. If the corridor does not support special characters, enter the name as it appears in the bank's records without unsupported characters."]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete all required fields in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bank information"]}," step."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"One payout method per beneficiary"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A beneficiary can only be associated with one payout method. To pay the same beneficiary in a different currency or over a different rail, create a separate beneficiary profile."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Finish"]},"."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The new beneficiary is created and is now available for selection when you create a payment. To confirm, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiaries"]}," to view the updated list."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-beneficiary-details","__idx":3},"children":["View beneficiary details"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the left navigation, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiaries"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Locate and select the beneficiary you want to view."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The beneficiary's identity details and bank information are displayed in a panel on the right."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"edit-a-beneficiary","__idx":4},"children":["Edit a beneficiary"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the left navigation, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiaries"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the beneficiary you want to edit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the details panel, select the edit icon next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Details"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bank Information"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make your changes and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Grayed-out fields contain core identity information and cannot be edited. Contact your Ripple representative if you need to change this information."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delete-a-beneficiary","__idx":5},"children":["Delete a beneficiary"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Deleting a beneficiary removes it from your beneficiary list and makes it unavailable for future payments."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the left navigation, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beneficiaries"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the beneficiary you want to delete."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the details panel, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["..."]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete Beneficiary"]}," dialog, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The beneficiary is removed and will no longer appear when creating a new payment."]}]},"headings":[{"value":"Manage beneficiaries","id":"manage-beneficiaries","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Add a beneficiary","id":"add-a-beneficiary","depth":2},{"value":"View beneficiary details","id":"view-beneficiary-details","depth":2},{"value":"Edit a beneficiary","id":"edit-a-beneficiary","depth":2},{"value":"Delete a beneficiary","id":"delete-a-beneficiary","depth":2}],"frontmatter":{"title":"Manage beneficiaries","seo":{"title":"Manage beneficiaries"}},"lastModified":"2026-05-27T18:08:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-direct-2/user-interface/guides/manage-beneficiaries","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}