HiRaiser integrates your credit card payment processor via API (Application Program Interface), which allows communication between two software applications – in this case between the payment gateway and HiRaiser.
What information to provide
To set up your online payments integration, we need:
The name of your payment gateway company. This may be the same as your payment processor, or it could be a different company. The gateway is the entity that collects the customer/donor’s info and provides the online approval. The processor is the entity that transfers the info and the money between the banks. We need the gateway.
The API keys for your payment gateway account. You can find or generate these in your account settings.
Depending on the company you are using, they have different names for these API keys.
For example:
- Stripe: Publishable Key and Secret Key
- Authorize.net: API Login ID and Transaction Key
How to provide it
IMPORTANT: Do not email sensitive payment gateway credentials – they need to be shared with us securely as follows:
- Log into your HiRaiser dashboard
- Select one of your campaigns
- Go to the Settings tab
- Paste the API information into the “Secure Admin Notes” field at the bottom of the page
- Click "Save"
Your API Login ID or Public Key should be available in your payment gateway account settings.
Your Transaction Key or Secret Key will not be available there – it is generally provided to you only once, and you have to save it somewhere secure for future reference (like a password).
If you don't have it readily available, you have two options:
- Try to retrieve it from an existing website or application where it is in use – you might be able to find it in your settings there.
- Request a new one.
Note: With most payment gateway/processor accounts you can only have one active Transaction Key or Secret Key at a time. If you don’t have y on record and request a new one, the previous API key might be cancelled and will no longer work. Any donate pages or applications using the previous key will stop working, and will need to be updated.
Payment Gateway Settings
The following settings should be set in your payment gateway account.
Authorize.net
- Enable Customer Information Manager – to edit donations and allow for recurring donations
- The ARB (Automated Recurring Billing) feature should be turned on
- Velocity filter – to allow for high volume campaigns, if needed
- Address Verification System – make sure it’s not too strict
Stripe
- Make sure your account us approved for API use. See here.
- Postal Code verification Rule – turn it off
Others – general settings to check
- Make sure address match requirements and other security settings are not too strict
- Make sure to allow recurring payments and/or subscriptions
If you have trouble with any part of the process, or if you prefer that we handle it, you can give HiRaiser access or create a developer user for HiRaiser on your account, and we’ll take care of it for you. Use team@hiraiser.com as the user to invite to your account.