Get FX transfer rates, fees, and delivery estimates.
Learn how to create, update, and use quotes to check FX rates, fees, and delivery estimates, enabling seamless money transfers with Wise Platform.
The send money flow begins with the creation of a quote to transfer an FX payment.
| A quote defines: | And will return: |
|---|---|
| Which currencies you’re converting | The rate and any fees |
| How much to send or receive | Estimated delivery speed |
| Who is sending and receiving the money | Available methods to fund the transfer |
There are two types of quotes:
Unauthenticated Quotes
POST /v3/quotes (optional)
Purpose:
- Optional to offer fast estimates for illustration
- No Auth or ProfileID needed
- But can’t be used to create real transfers
Authenticated Quotes
POST /v3/profiles/{profileId}/quotes
Purpose:
- Required to create a real transfer
- Must be assoicated with profile
- Needs updating with recipient for accurate fees
Providing payin and payout details improves the accuraty of the quote.
| Feature | Authenticated | Unauthenticated |
|---|---|---|
| Authentication | Required (OAuth 2.0) | Optional |
| Profile ID | Required | Not applicable |
| Quote ID | Generated | Not generated |
| Can create transfer | ✅ Yes | ❌ No |
| Rate locking | Available | Not available |
| Use case | Real transactions | Display/marketing |
| Rate limits | More restrictive | More permissive |
Typically there's 2 or 3 steps involved in creating a quote that can be used for a transfer.
Configure pricing
(Optional) Allows partners to override pricing per quote via pricing configuration.
Most partners can skip this step.
Create a quote
Provide a profile ID (the account sending the money), the currencies, and either the amount to send or to receive (never both).
Add the recipient
The quote must be updated to include the recipient of the transfer. This will ensure you have accurate fees, delivery estimates, and the payout network.
The mid‑market exchange rate is locked when the authenticated quote is created and typically remains valid for 30 minutes, giving the user time to complete the flow.
The fee and price objects for each payin option are included in the quote response. They provide a summary and detailed views of the fees to be charged on the transfer.
- The
feeobject gives a summary of the fees. - The
transferwisefee includes any taxes or fees that Wise will charge. - Additional fields, such as
payIn,discountandpartner, include any amounts as applicable. - The
totalfield sums all fees and discounts for that payment option. - The
priceobject further breaks down the fees and discounts as line items. This will include any discounts, fees, or taxes and give the appropriate name for each.
Any transfer to or from BRL will always include an IOF Tax fee, which is collected during the transfer funding process. This should be shown to users as a distinct line item separate from all other fees.
The sandbox provides realistic but not live rates, so the quote you receive when you test may differ from what is available in the production environment.
In the sandbox, you cannot test a rateType of FLOATING.
Speak with the Wise team if you have further questions about testing quotes in the sandbox.