Requirements
- A Wise Business account with access to API tokens.
- A full-access personal API token created for that Business account.
- Two-factor authentication enabled for the FirstPromoter admin managing the connection.
Connect your Business account
1
Create an API token in Wise
In Wise, open Connect and manage apps → API tokens, add a token, and select full access. Complete Wise’s verification and copy the token.
2
Save the token in FirstPromoter
Open Settings → Integrations → Wise. Choose Production for a real Wise account, paste your token, and select Save token. Confirm with your FirstPromoter verification code.FirstPromoter encrypts the token. The field is blank when you reopen the integration; the saved token is never returned to the browser.
3
Choose the Business profile
If your token can access several Business profiles, select the profile that will pay your affiliates and select Save profile. A single Business profile is selected automatically.
4
Enable payouts
Test the connection, then select Enable payouts and confirm the change.
Affiliates choose where to receive money
When Wise payouts are enabled, affiliates open My payouts → Payout methods in the affiliate portal, add or edit Wise, and choose a receiving destination under Send payouts to:- Wise balance: choose Wisetag, Email or Phone number, enter your identifier, and wait for the green checkmark and recipient name. Check the name, then save the payout method to confirm it. FirstPromoter sends to that Wise balance; bank details are not required. For phone numbers, include the country code.
- Wise balance using receiving details: if lookup is unavailable, select Use Wise receiving account details instead. In Wise, open Home → the payout currency → Account details and copy the receiving details for the selected payment route. Availability depends on country and currency; see Wise’s receiving guide.
- Bank account: provide your own bank account’s receiving details for the payout currency. The payout goes to that bank account.
- Arrange with the company (email only): keep the existing email-based CSV or admin-assisted setup.
If Wise cannot find an email
Open Settings → Privacy and security → Find me by in Wise. Enable Wisetag and copy it exactly. If email or phone discovery options are available, you can enable them too. Some accounts only show Wisetag, so an email toggle is not required. Check that you are sharing the identifier for the intended Wise profile. Wise’s discoverability guide explains the privacy settings. You can keep discoverability off and use your Wise currency account details instead. The email-only manual option does not verify a Wise account or select a balance. The balance lookup must return a verified recipient before the destination can be saved. The account-details workflow above does not depend on email discovery.Balance lookup only works when Wise can resolve an existing discoverable recipient and permits the route for the paying account. If lookup is unavailable, use receiving account details. Wise’s separate email-claim transfer flow is not used for automated batches. Its availability depends on the transaction, and Wise does not support testing email-recipient transfers in sandbox. See Wise’s recipient reference.
Admin-assisted recipient assignment
For affiliates using the email-only option, open their Wise payout method in the admin dashboard and select Load Wise recipients (shown while Wise payouts are enabled). Choose the recipient that matches the receiving details the affiliate has confirmed. A saved bank recipient can represent their Wise currency account details or an external bank account. If the recipient is missing, add those details in Wise and reload. Only active recipients from your selected Business profile, in your company currency, are selectable. Supported routes include USD local transfers, GBP accounts, IBAN and SWIFT where Wise supports the route. Wise validates each actual quote and transfer when the batch is prepared. Leave the recipient unassigned to continue using CSV. Changing only the Wise email keeps the saved assignment, because the email is used only for the CSV file. Admins can also switch to Wise balance or Bank account to enter and verify new receiving details directly.Prepare and approve a batch
- Select the affiliate payouts in FirstPromoter, select Pay, and choose Prepare Wise batch. This option appears only while the integration is connected and Wise payouts are enabled.
- Confirm the payout with your verification code.
- FirstPromoter prepares the transfers and displays Approve in Wise.
- Open the batch in Wise, review its recipients, amounts and fees, then fund it using Wise’s available payment methods.
- FirstPromoter checks transfer statuses and updates the payouts automatically.
Statuses and recovery
While a batch is waiting for you to fund it in Wise, the batch page shows This batch is waiting for your approval with an Approve in Wise button. Once Wise sees the funds, the batch continues processing on its own. Each payout in the batch has its own status:- Processing: Wise has not reported a final result. This includes payouts in a batch that is still waiting for funds. Do not pay the same affiliate again outside the batch without checking Wise first.
- Completed: Wise reported the transfer as sent; FirstPromoter updates the payout and creates its invoice where self-billing is enabled.
- Failed: Wise rejected the transfer or confirmed a cancellation/refund. Review the error before retrying.
Pay Wise affiliates without the integration
If you have not connected Wise, or Wise payouts are disabled, the Wise payout method stays available to affiliates with a single Wise email field. Pay them as before:- Select the payouts and select Pay.
- Choose Externally in bulk and download Pay in bulk_WISE.csv, or choose Externally one-by-one to pay each affiliate separately.
- In Wise, select Send money → Batch, upload the file, review it and pay.
- Back in FirstPromoter, select Mark As Paid.