Zum Inhalt springen
← Back to Docs

Configuration

1. API Tab

  • Wise API Token: Create a token in your Wise account under Settings → Developer Tools → API Tokens. Grant Read + Transfers + Recipient accounts permissions.
  • Wise Profile ID: Click Fetch Profile ID from Wise and copy the numeric ID of your business profile.
  • Environment: Use Production for live orders. Sandbox uses api.sandbox.transferwise.tech.

2. Account Mapping Tab

  • Set your Payment Reference Prefix (default: KLC). References will appear as KLC-42-X7KP3Q.
  • Click Fetch Wise Accounts to load all your Wise receiving accounts. Select the correct account per currency and save.
  • Enable Cent-offset uniqueness if you want to add 0–48¢ to each order's expected amount for collision-safe amount-only matching.

3. Reconciliation Tab — Webhook setup

  1. Copy the Webhook URL shown in the settings.
  2. In your Wise account go to Settings → Webhooks and add a new webhook with:
    • URL: the copied webhook URL
    • Event: balances#credit and transfers#state-change
  3. Copy the Public Key (PEM) from Wise webhook details and paste it into the Wise Webhook Public Key field in settings. This enables SHA256-RSA signature verification.
  4. Click Fetch Wise Balances and map each balance ID to its currency. This is required for the polling fallback.
  5. Optionally enable Polling Fallback and choose an interval (15 / 30 / 60 min).
Next: Reconciliation →