Recipients

After creating a quote, your application next needs to allow users to choose who will receive the funds, often referred to as the recipient or beneficiary.

This can either be completed by selecting an existing recipient the user previously created or by the user entering data to create a new one. What data that needs to be entered is dependent on a number of factors, which is why it can be requested as part of our dynamic forms solution.

Once the recipientID is known, your application is ready to create a transfer.

Listing Current Recipients

Each profile contains a list of active recipients that the user has previously sent to. Your application should use the list recipients by currency API to present a list of recipients to the user along with the ability to create a new recipient.

Once a user selects a particular recipient, your application should then update the quote with the recipient.

Always load a fresh set of recipient details from the Wise API when displaying a list or specific information about the recipient.

Creating a New Recipient

When creating a new recipient, there are a number of factors to consider, such as the currency pair, where the account is based, the amount of the transfer, and many more items. These factors additionally change on a regular basis, meaning creating and maintaining recipient account can be difficult.

With Wise, we have prepared a set of dynamic forms that work in a predictable and functional way. This allows you to rely on a single API endpoint to retrieve the details required for a particular quote and display that to users.

In order to do this, please see the Account Requirements Dynamic Forms API reference. This explains how to retrieve the account detail requirements, how to display and validate the data, and how to collect additional details.

Once the user has provided the details, your application will need to create the account. This can be done with the Create a New Recipient API.

Account Requirements Dynamic Forms are an absolute must for all integrations. This ensures that your application always has the most up-to-date information for creating recipients and that the flow will have fewer errors.

Not including dynamic forms for account requirements will result in your application breaking upon a change to those requirements, with users no longer able to create or update that type of recipient. If you are concerned about including dynamic forms in your application, please speak with the Wise team.

Updating Quote with Recipient

Now that a recipient has been selected you need to update the quote with that recipient in order for Wise to calculate if the price has changed based on that selection.

For example, the fees and delivery estimate are different in the case of sending USD to a country other than the USA - we call this Global USD. Multiple factors can play into this, so it is important to complete this step.

You need to do this in order to show the customer the correct final price and delivery estimate time before they commit to creating and funding the transfer.

Please see the update quote API reference for full details on how to complete this update.

Updating a quote with a recipient ID is nto a required step, and in certain integrations is not necessary. Our team will help determine if this step can be removed from your application.