Skip to main content

Set up DollarPay yourself

DollarPay takes payments and pays out for the methods your brand offers through it. You can connect your own DollarPay merchant account from the admin tool. Nobody needs to edit a setup file or ask for a deploy.

This guide is for Penguin Sweeps and Emma Sweeps. Both use the same admin tool and the same screens. The screenshots come from the Penguin practice view. In Emma you will see the same labels, but the web addresses inside the setup guide show Emma's own site.

Before you start​

  • You must be a super admin. Other staff cannot see the Connect API tab.
  • Open Payments in the left menu. You should see two tabs, Vendors and Connect API. If Connect API is missing, you are not a super admin, or Connect is switched off for this brand. Ask whoever gave you access.
  • Have your DollarPay merchant account details ready.

What you will do​

  1. Get your merchant ID and merchant key from DollarPay.
  2. Give DollarPay your outbound IP.
  3. Paste the details into the admin tool and save.
  4. Run a connection test.
  5. Activate.

Saved keys stay inactive until a test passes and you press Activate. Players cannot use DollarPay before that.

Step 1. Open the setup guide​

Go to Payments → Connect API. On the DollarPay row, press How to set up.

The Connect API tab with a How to set up and a Connect API button for each vendor

A window called Set up DollarPay opens. It has four steps and these values, each with a Copy button:

  • Deposit callback URL
  • Withdrawal callback URL
  • Outbound IP

It also shows the API base URL for reference.

The Set up DollarPay window

Always copy from your own window. The IP and the addresses are specific to your brand.

Step 2. Do the DollarPay side​

  1. Get your merchant ID and merchant key from DollarPay.
  2. Send DollarPay the Outbound IP from the window and ask them to whitelist it.
  3. You do not need to enter the callback URLs anywhere. They are sent to DollarPay automatically with each request. The two addresses in the window are only for your reference, for example if DollarPay support asks for them.

Press Done to close the window.

Step 3. Paste the details and save​

On the DollarPay row, press Connect API. A window called DollarPay · Connect API opens.

The DollarPay Connect API window

FieldWhat to put in it
Merchant ID (required)Your DollarPay merchant ID
Merchant key (required)Your DollarPay merchant key
Reason for this changeA short note, for example "First setup". It is kept in the audit trail.

The merchant key is write only. Once saved you see a hidden mark and its length with two buttons. Replace lets you type a new key. Compare checks a key you have against the saved one without showing it. Leave a field blank to keep what is saved.

Press Save connection.

Step 4. Test the connection​

In the same window, find Connection test and press Test connection. It checks the saved details with DollarPay. No money moves.

You get a list of steps, each marked Passed, Failed, Skipped or Not offered. If a step failed, read the reason under it, fix the field, save, and test again.

Good to know about tests:

  • If you changed fields and did not save, the test is a draft test and cannot unlock Activate. Save first, then test.
  • You must wait about 2 minutes between tests.
  • There is a limit of 20 tests a day.
  • A passing test counts for 24 hours. After that, run it again before you activate.

Step 5. Activate​

After a passing test the window says The saved keys passed. You can activate until a date and time, with an Activate button.

  1. Press Activate.
  2. Type a reason. It is required.
  3. Press Activate again to confirm.

The window then says DollarPay is active for players. To stop, press Deactivate and give a reason. Players can no longer use DollarPay. It does not fall back to older settings.

Check that it works​

Open Payments → Vendors. DollarPay shows Available, On hold and Total. This confirms the admin tool can talk to your account. Balances refresh at most once a minute. Use Refresh if needed.

If something goes wrong​

What you seeWhat to do
Connect API tab is missingYou are not a super admin, or Connect is off for this brand.
A test step failedRead the reason under it. Check the merchant ID and key, and that DollarPay whitelisted the Outbound IP.
Wait 2 minutes between tests.Wait, then test again.
Daily limit reached (20 tests).Try again tomorrow.
The save answer was not received.Press Check original request before you save again.
The window offers Review latest settingsSomeone else saved at the same time. Press it, then redo your edit.
A player says they paid but the money is missingDo not retry. Follow Someone paid us outside the app or ask your support contact.