Ctrlk
Back To Rafflex.io
For the complete documentation index, see llms.txt. This page is also available as Markdown.

FumoPay

Connect FumoPay so approved customer withdrawals are paid automatically, instead of you paying each one by hand.

Automatic payouts are currently in beta. If you would like access to this feature, please contact support.

This guide sets up FumoPay as your automatic payout provider. If you have not chosen a provider yet, start on the Payouts overview.

Before you start

You will need:

  1. A FumoPay account. Sign up with FumoPay first and complete any checks they ask for. Payouts cannot work until your FumoPay account is approved and ready to send money.

  2. Your FumoPay keys. You copy these from your FumoPay merchant portal into RaffleX. We list exactly which ones below.

  3. A few minutes to test. Every new setup starts in a safe test mode so you can check the connection before any real money moves.

Step 1: Open the Payouts settings

  1. Log in to your RaffleX admin panel.

  2. In the left menu, go to Settings.

  3. Open the Payouts page.

  4. Set Payout Provider to FumoPay (Automatic). The FumoPay fields then appear.

When you have finished making changes on this page, always click Save Settings at the bottom.

Step 2: Enter your FumoPay details

You get all of these from your FumoPay merchant portal. The first three are required. The verification template is optional, and so is the webhook step further down.

Field
Required?
What to enter

FumoPay Profile Key

Required

The profile key from your FumoPay payment profile.

FumoPay Secret Key

Required

The secret key from the same payment profile. Keep this private.

FumoPay Payout Creator Email

Required

The email of the person on your FumoPay business profile who creates payouts. Use a mailbox your team actually watches, as this is where FumoPay would send any one-time code if it ever needs one to approve a payment. Payouts will fail until this is filled in.

FumoPay Verification Template

Optional

Leave this blank unless FumoPay have given you a specific template to use.

Where to find your FumoPay keys

Log in to your FumoPay merchant portal. There are two separate portals, one for testing and one for real payments:

When FumoPay approve your account they create your first payment profile. Your profile key and secret key belong to that profile, and you copy them from the portal into the fields above.

Make sure you copy the keys from the right portal. Use the sandbox keys (merchant.fumopay.dev) while you are testing, and swap them for the live keys (merchant.fumopay.app) when you go live. Mixing them up is the most common reason the connection test fails.

Optional: turn on instant status updates

For payout statuses to update almost instantly, tell FumoPay where to send them:

  1. In your FumoPay business profile, open Profile, then Details.

  2. Set your webhook URL to https://yourdomain.com/api/webhooks/fumopay, replacing yourdomain.com with your own site address.

This step is optional. Payouts still work without it, but statuses in RaffleX will update a little more slowly.

Step 3: How and when payouts happen

These settings control whether payouts run and when you still need to step in.

Setting
What it does

Enable Automatic Payouts

The master on/off switch. Leave this off while you set up and test. Turn it on when you are ready for FumoPay to start paying withdrawals.

Test Mode

On by default. While it is on, everything runs against the FumoPay sandbox and no real money moves. Turn it off only when you are ready to go live.

Auto-Payout Max (GBP)

The largest withdrawal that is paid automatically. Anything at or below this amount goes through on its own. Anything above it waits for you to approve it by hand. Set it to 0 to approve every payout yourself.

Retry Max Attempts

How many times a failed payout is tried again automatically before it is handed to you to sort out. The default is 3.

Enable Manual Bank Details Fallback

On by default. If a customer's bank cannot be verified automatically, or their bank is not supported, this lets them enter their bank details by hand so you can still pay them the manual way.

Start with Auto-Payout Max set low, or at 0, while you get comfortable. That way larger amounts still come to you for a final check even after automatic payouts are live.

Step 4: Test the connection

Once you have entered and saved your FumoPay details, a Test Provider Connection button appears on the page.

  1. Click Test Provider Connection.

  2. RaffleX checks your keys with FumoPay and shows the result.

  3. The result tells you whether you are in sandbox or live mode, and lists each check as a pass or a fail.

If anything fails, re-check the fields above. The most common cause is copying keys from the wrong portal (sandbox keys while in live mode, or the other way round).

Step 5: Go live

When your test connection passes and you are happy with your settings:

  1. Turn Test Mode off.

  2. Make sure your FumoPay fields now hold your live keys (merchant.fumopay.app), not the sandbox ones.

  3. Turn Enable Automatic Payouts on.

  4. Click Save Settings.

Automatic payouts are now active. Approved withdrawals at or below your Auto-Payout Max will be paid by FumoPay, and anything above it will still come to you for approval.

FAQ

Can I switch back to manual later?

Yes. Set Payout Provider back to Manual / Bank Transfer, or turn Enable Automatic Payouts off, and you are back to paying withdrawals by hand.

Will every withdrawal be paid automatically?

Only those at or below your Auto-Payout Max (GBP). Anything above that amount waits for you to approve it. If you set the max to 0, you approve every payout yourself.

What happens if a customer's bank details cannot be verified?

If you leave Enable Manual Bank Details Fallback on, the customer can enter their details by hand and you pay them the manual way. If you turn it off, only automatically verified payouts are allowed.

Last updated