Payment Gateways
Configure Payment Gateway
Jomablue provides a means for offering Paid Registration, but we do not handle any financial transactions ourselves. These transactions are managed by a Payment Gateway. Currently, Jomablue supports the following Payment Gateways:
- Braintree (by Paypal)
- Stripe
Stripe
Find my Stripe Account Details
You can easily connect with Stripe and begin accepting credit cards using Jomablue.
When you select Add a New Gateway, you will see a series of fields. Below is an outline of each field and how to retrieve the necessary information from your Stripe Account.
Stripe Account Country (ISO 2 letters)
This is the country where the Stripe account was opened and corresponds to the address listed under account settings found here: https://dashboard.stripe.com/account
- Example codes: AU, US, GB
- A complete list of Alpha-2 codes can be found here: https://www.iban.com/country-codes
Charge Currency (3 letter ISO code)
Specify the currency you want to charge for this event. Stripe will automatically convert the charge currency into the currency of your Stripe account or bank account.
- Example codes: AUD, USD, CAD
- Supported Stripe currencies are listed here: https://stripe.com/docs/currencies
Environment
If you are using Publishable and Secret keys that are prefixed with “pk_live,” select “Production.”
If your keys from Stripe are enabled when "Viewing test data", select “Sandbox.”
Publishable Key (from Stripe Account)
This can be found in Stripe under Developer > API Keys
Secret Key (from Stripe Account)
This can also be found in Stripe under Developer > API Keys
Add Stripe details into Jomablue
Once you have gathered your Stripe details, proceed to enter them into Jomablue:
- Navigate to Registration > Configuration
- Click on the Payment Methods tab
- Click on Add new Gateway
4. Enter the gateway details you collected into the appropriate fields below
5. After entering the information, click Save, and we will automatically validate the credentials for you.
Braintree
Braintree Onboarding
Approval is required before you can set up a new customer account in Braintree. Other payment gateway providers may allow account setup before approval, which can result in significant costs if the application is declined after the initial setup. The advantage of using Braintree is that this approval process occurs upfront.
- If you already have a Braintree gateway approved and set up, great! Proceed to the section called Find my Braintree Account Details to configure Braintree with Jomablue.
- If you have not set up a Braintree account, go to the Braintree - Recommended Settings section to apply.
When submitting an application to Braintree, an authorised person must complete the application and provide bank statements. The sign-up process includes a financial review, which, if successful, will continue periodically thereafter.
If your application is initially rejected, it could be due to Braintree recognising third-party vendors as high risk. This may happen if you are an agency collecting payments on behalf of a client. In such cases, you will need to provide additional financial information for further consideration.
The purpose of the approval process is to assess a business’s financial security and stability. All online credit card processing businesses have financial underwriters who conduct an approval process for customers.
Should you need any further assistance please don't hesitate to reach out to your Jomablue Project Manager or our Customer Success Team at servicedesk@jomablue.com
Find my Braintree Account Details
To add Braintree as a Payment Gateway in Jomablue, you must gather the following details from Braintree and save them in Jomablue:
- ISO Country code
- Currency
- Account ID
- Merchant ID
- Public Key
- Private Key
- Environment
ISO Country Code
This ISO Alpha-2 code of the country where the account was set up.
- Example codes: AU, US, GB
- A complete list of Alpha-2 codes can be found here: https://www.iban.com/country-codes
Merchant ID, Account ID and Currency
In Braintree, navigate to Account > Merchant Account Info
Private and Public Keys
In Braintree, navigate to Settings > API Keys > Generate a New API Key
Environment
By default, you should enter production unless you have specifically and knowingly configured a Braintree sandbox.
Add Braintree details into Jomablue
To add Braintree as a payment method in Jomablue:
- Navigate to Configuration (under Registration in the left-hand menu)
- Select Payment Methods
- Press Add new Gateway
4. You can then copy the details you retrieved from Braintree.
5. After entering your details, click Save and we will automatically validate the information for you.
Braintree - Recommended Settings
The following recommendations are suggestions only, and your configurations may differ. It’s best to consult with Braintree regarding the setup that best suits your organisation.
Enhance Fraud Protection
Enabling CVV checking can reduce fraudulent transactions and further validate the credit card details entered. Since entering a CVV is standard practice for online credit card users, we recommend enabling this feature.
1. Go to Settings > Processing
2. Click Options
3. Select the following settings
Duplicate handling
This setting prevents users from experiencing double charges, saving time and paperwork.
- Go to Settings > Processing
- Enable Duplicate Transaction Checking
- Click Options
4. Set duplicate transaction time to 30 seconds
Enhanced Braintree Security
Enable Two-Factor Authentication to protect your Braintree account.
- Click Account > My User
- Enable Two-Factor Authentication
Using Braintree Sandbox
You can sign up for a Braintree Sandbox to test transactions through Braintree.
Here are the steps:
- Register here: https://www.braintreepayments.com/au/sandbox
- Once registered, follow the usual guide to obtain the Braintree account details discussed in the Find my Braintree Account Details section for placement into a Jomablue Test event.
Add Braintree Staging to Jomablue
When adding Braintree details to the Jomablue Payments page, ensure the Environment is set to "sandbox".
After entering the Braintree Staging details, you can check out of a Site using the test credit card details (assuming all other Jomablue steps have been completed).
For more information, see the Braintree Staging Articles:
Staging Credit Cards:
https://developers.braintreepayments.com/guides/credit-cards/testing-go-live/php
Error Codes and Transaction Amount Limits:
https://developers.braintreepayments.com/reference/general/testing/ruby
Payments FAQ
Q. Which payment gateways can be used with Jomablue?
A. Jomablue supports Stripe and Braintree by PayPal.
Q. Which payment gateway is right for me?
A. For projected annual revenue of AUD 250,000 or less, Stripe requires no pre-approvals and can be set up immediately. For higher projected revenues, both Braintree and Stripe are viable options.
Q. Can we use our existing PayPal account?
A. No, you cannot use a PayPal account. The recipient of the funds requires a specific Braintree account.
Q. If I have an existing Stripe or Braintree account, can I use that?
A. Absolutely.
Q. How long does it take to set up a Braintree account?
A. After submitting all required paperwork, it typically takes 1 to 2 weeks for the account to be set up.
Q. What do we need to start the Braintree setup process?
A. Jomablue will send an introductory email to the Braintree Account Manager, who has specific knowledge of the Jomablue product and provides the appropriate support during the setup phase.
Q. How much does it cost to use Braintree cost?
A. Braintree is an external organisation separate from Jomablue, so we cannot provide pricing on their services. Jomablue’s introductory email to the assigned Account Manager is the first step. Choosing a gateway provider that offers the best technology solution while being competitive was a key factor in our selection of Braintree.
Q. How long does it take to set up a Stripe account?
A. Once you create your Stripe account, you can start using it immediately
Q. How much does it cost to use Stripe?
A. Stripe is an external organisation from Jomablue, and we cannot provide pricing on their services. However, their pricing information is available on their website.
Q. What about PCI Compliance?
A. With both Stripe and Braintree, you will need to complete a self-assessment questionnaire regarding PCI compliance. This questionnaire takes about 20 minutes to complete and will be sent directly to you by either provider.
