--- title: "Wise Integration" slug: "wise-integration" updated: 2026-07-15T19:56:18Z published: 2026-07-15T19:56:18Z canonical: "help.eddy.app/wise-integration" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://help.eddy.app/llms.txt > Use this file to discover all available pages before exploring further. # Wise Integration Wise is the payout method that does the most work for you. Once connected, you pay a whole batch of payees in a couple of clicks and transfer statuses flow back onto your documents on their own, with no manual reconciliation Setup is a one-time exchange of keys between the two platforms. > [!NOTE] > 📋 Before you start > > You need a Wise **Business** account, and you need to be its **admin or owner**. Personal Wise accounts can't be used, and non-admin users can't create the API token this requires. --- ### Step 1: Create an API token in Wise 1. Log into Wise as the account admin or owner. 2. Go to `Settings` > `Integration and Tools` > `API Tokens`. 3. Click **Add New Token**. 4. Give it a name, set permissions to **full access**, and create it. 5. Reveal the token and copy it. ### Step 2: Connect Wise in eddy.app 1. Go to `Settings` > `Integrations`. 2. Click to enable the Wise integration and paste your API key. 3. Choose the fee bearer: either you (**sender**) or your payee (**recipient**). 4. Click **Confirm**. 5. Select the relevant profile ID, then click **Confirm** again. ### Step 3: Exchange the public key 1. In the Wise integration settings in eddy.app, download the Wise public key and save the file. 2. Back in Wise, go to **Manage Public Keys** and upload that file. 3. Name the key `eddy.app`. ### Step 4: Activate Wise as a payout method Return to eddy.app and confirm Wise is activated on the payout methods page of your [self-billing settings](https://beta.eddy.app/app/settings/self_billing_options). Bank transfer now appears as an option for your payees, and you can start grouping documents for payment. See [Generate Invoices and Initiate Payouts](/home/docs/generate-invoices-and-initiate-payouts). --- ### Keep your keys safe > [!WARNING] > **🔒 API key sensitivity** > > Your API keys are sensitive and should never be shared. Our support team will never ask you for them. If you suspect a breach or unauthorized access, act immediately: 1. **Delete the compromised keys** in Wise. 2. **Create new keys** as soon as possible. 3. **Update the integration** in eddy.app: disable it, then enable it again with the new keys. --- ### Troubleshooting #### A transfer couldn't be created in Wise [eddy.app](http://eddy.app) cancels that transfer and retries it in your next payment group. If it keeps failing, check the payee's payment details with them, and check Wise for any account-level restriction. #### The payment group failed to fund Your Wise balance was too low to cover the batch. Top up the account and retry the payment group. #### A payment bounced back Ask the payee to correct their payment details in the Payee Portal before you generate a new payment group. Retrying against the same wrong details bounces again. When using wise, you can only correct payment details once a payment reaches a finale state **Funds Refunded**. See [Document and Payment Statuses](/home/docs/payment-statuses). #### I need to change who pays the fees The fee bearer is set when you connect the integration. To change it, edit the Wise integration and change the fee bearer settings. --- **Related Articles** - [Self-Billing Set-up](/docs/self-billing-set-up) - [Generate Invoices and Initiate Payouts](/docs/generate-invoices-and-initiate-payouts) - [Document and Payment Statuses](/docs/payment-statuses) - [Currencies and Countries for Bank Transfers](/docs/bank-transfer-currencies) - [Integrations](/docs/integrations-merlin) --- [eddy.app](http://eddy.app) is an independent platform and integrations with third-party services do not imply affiliation, endorsement, or official partnership.