Skip to main content
FirstPromoter can prepare payout batches in your own Wise Business account and track each transfer until it settles. You review and fund the batch in Wise. FirstPromoter does not hold your money. The integration is optional. Without it, Wise works as before: affiliates add their Wise email and you pay them with a Wise CSV file (see Pay Wise affiliates without the integration).

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.
You do not need a Wise Platform partner agreement, an OAuth client ID or secret, or API tokens from your affiliates. Wise documents this workflow in its Business payouts guide.

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.
The destination must be able to receive your FirstPromoter company currency. Payouts use that currency automatically. The form shows Paid in [currency]; there is no separate currency selection or confirmation. For account details, FirstPromoter asks Wise which fields the payment route requires and updates the form when you choose your country or recipient type. Save the method and complete the verification prompt if requested. For a balance lookup, FirstPromoter keeps the confirmed Wise contact and checks the quoted balance recipient before each transfer. For receiving details, it creates the recipient on the company’s paying Business profile. You do not share an API token or sign in to Wise through FirstPromoter. While a payout is in a Wise batch that has started, its Wise payout method cannot be edited, deleted or replaced by another method. Wait until the batch settles. Authorized admins can add or edit the same Wise destination from Affiliates → the affiliate → Payout methods. They use the same identifier and receiving-details form, then save and complete their verification prompt when required. Only you and authorized company users can access your payout details. Affiliates cannot browse the company’s Wise recipient list. Changing the destination clears the old fields so you can enter the new account details.

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

  1. 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.
  2. Confirm the payout with your verification code.
  3. FirstPromoter prepares the transfers and displays Approve in Wise.
  4. Open the batch in Wise, review its recipients, amounts and fees, then fund it using Wise’s available payment methods.
  5. FirstPromoter checks transfer statuses and updates the payouts automatically.
Each batch group contains at most 1,000 transfers, so FirstPromoter splits larger batches into several Wise groups that you fund separately. The batch page shows a single Approve in Wise button that opens the group still waiting for funds. After Wise reports that group as funded, the button moves to the next unfunded group. Amounts are sent in the company currency; currency conversion is not offered by this version. Approving the payout in FirstPromoter does not fund the Wise batch. This integration always leaves funding to you in Wise, including in countries where Wise may permit API funding.

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.
A bounced transfer stays processing until Wise confirms the refund. If Wise returns the money after a payout was already completed, the payout stays completed, the batch shows a warning and the return is recorded in the Activity Log. Pay the affiliate again once they have checked their details. A transfer that remains unresolved for 30 days receives a warning and continues to be checked; elapsed time alone never makes it eligible for another payment.

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:
  1. Select the payouts and select Pay.
  2. Choose Externally in bulk and download Pay in bulk_WISE.csv, or choose Externally one-by-one to pay each affiliate separately.
  3. In Wise, select Send money → Batch, upload the file, review it and pay.
  4. Back in FirstPromoter, select Mark As Paid.
Affiliates who saved a Wise balance or Bank account destination while Wise payouts were enabled are asked for their Wise email the next time they edit the method. Until they add it, their row in the CSV file has no email, so Wise cannot pay it.

Change or disconnect the connection

Disabling Wise payouts keeps the Wise payout method available for the CSV flow above. You can disable payouts at any time, except while FirstPromoter is still sending a newly prepared batch to Wise. Batches already in Wise keep being checked until they settle. Finish active Wise batches before switching Business profiles or disconnecting. FirstPromoter cannot cancel a batch that is waiting for funds; cancel it in Wise instead. You can replace a token while payouts are pending if the new token accesses the same Business profile in the same environment. Selecting another Business profile clears every affiliate’s saved Wise recipient and turns Wise payouts off. Affected payout methods become incomplete until the affiliate or an admin saves their destination again. Disconnecting removes the token from FirstPromoter. It also clears every affiliate’s saved Wise recipient, the same as selecting another profile. Reconnecting does not restore them; each affiliate or an admin must save their destination again. You can also revoke the token in Wise. Revoking it before transfers settle prevents FirstPromoter from checking their status until a working token is saved again. To switch between Wise sandbox and production, disconnect first. Each environment has separate credentials, so this also clears saved recipients.

Sandbox testing

Use Sandbox with a token created at wise-sandbox.com. Production tokens and sandbox tokens are separate. Sandbox transfers do not move real money; settlement tests use Wise’s simulation endpoints.