USAePay is a supported payment processor in Donor Fuse. Follow these steps to obtain your API credentials and add USAePay as a gateway account in Donor Fuse.
Step 1: Obtain Your USAePay API Key and PIN
- Log in to the USAePay portal.
- From the main menu, go to Settings.
- Select API Keys from the submenu.
- In the top right, click Add API Key.
- In the next page:
- For Name, enter: Donor Fuse.
- For PIN, enter a 4-digit number of your choice.
- Click Apply at the bottom right.
- Your new API key will be displayed. Copy the key now, as it will only be visible once.
- You can now close the portal and enter your API key and PIN in Donor Fuse to complete your gateway setup.
Step 2: Add USAePay as a Gateway in Donor Fuse
- In your Donor Fuse dashboard, go to Settings.
- Click Gateway Accounts.
- Click Add New Gateway Account.
- In the popup:
- Type: Select USAePay from the dropdown.
- Internal Name: This is a required field. Enter a name such as
usaepay. If you have more than one USAePay account, use a unique name for each (for example,usaepay-main,usaepay-events). - API Key: Paste the API key you copied from the USAePay portal.
- API PIN: Enter the PIN you entered in the USAePay portal.
- Processing Fee Category (Optional): If you have the Donor Fuse Accounting Module enabled, you will see this optional field. Use it to select which fee account category should be used for transaction fees in batch deposits. (The system automatically generates deposits based on batch deposits to the bank.)
- Multi-Currency Settings: If your Donor Fuse account supports multiple currencies:
- Statement Currency: Select the currency your USAePay account is set up to use.
- Accepted Process Currencies: Select the same currency as above.
- All other fields are optional. Fill them in only if you have specific requirements.
- Click Save New Gateway Account to complete the setup.
Step 3: Test Your Integration
- Enter a small test transaction in Donor Fuse to confirm the connection is working.
- Check the transaction status in both Donor Fuse and your USAePay merchant portal.
Troubleshooting:
- If you encounter any error while testing or processing a payment using this gateway, check the error message:
- If the error message starts with
Processing Error: {error message}, this means the error is from the gateway (USAePay). Please contact their support directly. - If the error message does not start with
Processing Error:,contact Donor Fuse support.
- If the error message starts with
- You can always reach out to Donor Fuse support to help verify the issue if you are unsure.
Need Help?
If you need assistance locating credentials or connecting USAePay to Donor Fuse, contact USAePay support or the Donor Fuse support team.