How do I connect my Chase Hosted Payments account in raisin?

The steps to connect your Stripe Hosted Payments account in raisin

raisin uses "Hosted Payments" across the platform, which allows us to provide top-level security to you and your generous supporters.

With hosted payments, payment fields (Card Number, Card Name, Expiry and CVV) are rendered, or "embedded," within your raisin event pages, but are physically hosted by your payment gateway provider, Chase. This allows payment information to be processed directly through Chase without ever going through raisin.

Below are the steps to connect your Chase Hosted Payments account to raisin that your Client Experience Manager is happy to support directly with:

1. Add Hosted Payments Version 3 to your Chase account & copy your Secure ID and API Token.
2. Complete the Hosted Payments Version 3 Setup Form.
3. Authorize raisin’s domain (akaraisin.com) in your Chase account.
4. Enter your Chase account credentials into raisin.
5. Add your Chase account in raisin with the “Chase - Hosted” account type.
6. Begin using the Payment Gateway on Events in raisin.

Add Hosted Payments Version 3 to your Chase account & copy your Secure Account ID and API Token

In order to connect Chase's Hosted Payments form in raisin, you will need to have the Hosted Payments Version 3 (HPS 3.0), added to your Chase account if it isn't already.

To do this, email Chase's production team at Merchant.support@chase.com, and request they add the Hosted Payments Version 3 (HPS 3.0) to your Chase account. You will also want to provide them our raisin Chase Payment Tech HPS 3.0 certification.  Please reach out to your raisin Client Experience Manager to obtain a copy of this Certification.

Chase will request your organization's existing Secure Account ID and API Token to make the change. Upon adding the Hosted Payments Version 3 to your Chase account, they should also provide your new Secure Account ID and API Token.

You will also need to request Chase to whitelist raisin's following IP addresses for your merchant account:

• 69.46.109.217
• 69.46.109.212
  
  

You can also call Chase directly at 1-800-254-9556, if you have any issues locating your existing Secured ID and API token, or if they do not respond to you within 48 hours. 

Please note there may be a fee on Chase's side in order to upgrade your account to their Hosted Payments Version 3 (HPS 3.0). For more information on this, please connect with your Chase representative. 

Complete the Hosted Payments Version 3 Setup form

The steps to complete the Hosted Payments Version 3 Setup Form in your Chase account are as follows:

1. Login into your Chase account.
2. In the main navigation menu, select "HPS Forms".
   
3. Enter "default" in the search bar, at the top of the right-hand side of the page.
   
   
4. Select the duplicate button, (icon circled above) on the template listed as "default", which will open a new form.
5. On the new form, enter the format "raisin_{language code}" in the Form Name field (pictured below).
   
   - If your raisin account was setup in English Canadian, the language code would be "en-CA"
   - If your raisin account was setup in English US, the language code would be "en-US"
   -  If your raisin account was setup in French, the language code would be "fr-CA"
   
   

   If your raisin account is setup as bilingual (English & French) you will need to create a form for each language, using the formats above. Therefore, you would complete  these steps 5-8 for one language, then, repeat the steps again, for the other language. 

   
   
   
   
   
6. Click on the "Advanced" tab (pictured above). Copy the sample HTML and CSS (provided below) based on your account language, and add each to their respective column, on the page.
   
   You can copy the applicable HTML and CSS below:
   
   - English Canadian HTML
   - English US HTML 
   - French HTML
   - CSS (used for all languages)
   
   
   
   
   
   Your organization has the ability to update the colour of the "Donate" button that appears beneath the credit card fields, during the transaction process, to match your brand colour. This colour can be changed in the CSS panel (screenshot above). Please note, this will be the colour and text for the button for ALL of your events. Event level branding for this particular button is not available.  
   
   To change the colour of this button:
   1) Search for ".hps-row.form-buttons .hps-button" in the CSS panel (see screenshot above).
   2) Update the button background color in line "background-color: #1975D2 !important;". You'll want to replace "#1975D2" with your HEX Code of choice.
   3) Update the button text color in line "color: #FFF;". You'll want to replace "#FFF" with your HEX Code.
   4) Switch the tab to "Basic" to preview changes.
   5) Save changes.
   
   Note: If you would prefer to not change the colour of this button, it will appear in raisin's default blue colour — HEX Code: #1975d2 (example below).
   
   
   
   
7. Click "Save" at the top right-hand side of the form. This will create the Hosted Payments Version 3 Setup Form, in your Chase account.
   
   If your raisin account was setup as bilingual (English & French) you will need to create a form for each language, using the formats above. Therefore, complete steps 5-8 for one language, then, repeat these steps again, for the other language. 

Authorize raisin’s domain in your Chase account. 

1. In your Chase account, click on the "Profiles" tab, in the main navigation menu, at the top of the page. 
2. Click on the "Edit" button beside your account (pencil icon).
   

   

3. Under the Authorized Domains area, add "akaraisin.com,uat.akaraisin.com".
   

   

4. Click "Save".
   
   

Copy your Chase account credentials

In your Chase account, find and copy down your Merchant ID and Terminal ID

Add your Chase account in raisin with the “Chase - Hosted” account type

Using your Chase credentials and the Keys you created, you can add your Chase account in raisin. This new Payment Account will replace your current Payment Account on raisin. The steps are as follows:

1. Navigate to Manage Payment Accounts under General Setup.
   
   

2. Click Create New Payment Account.
   
   
   
   
3. Establish an Account Name for the new Chase Hosted account. This can be anything you'd like
   
   
   
   
4. Choose "Chase - Hosted" from the drop-down list of Payment Gateways.
   
   
   
   
5. Choose the currency of the gateway. (Canadian or US dollars)
   
   
   
   
6. Enter your Merchant ID, Terminal ID, Hosted Secure ID, and Hosted Secure API token.
   
   
   
   
   

   Please note your Merchant ID/Payment Network Services Number must be 12 digits. If it is not, zeros should be prepended to it in order to total the digits to 12.

   
   
   
7. Create a Transaction Code Prefix. The Transaction Code prefix is public facing, and will be part of the Transaction Code and Order ID reported in raisin and your Chase journal respectively. This can be anything you'd like and will help you identify transactions that came through raisin. 
   
   
   
   
8. Leave the Test Account box unchecked
   
   
   
9. Click Add.
   
   
   
   

Begin using your payment gateway on raisin events

You can now begin using your new payment gateway on your raisin events. Before setting the new Payment Gateway Account on your events, we strongly recommend testing the gateway to make sure the set up was error free and it can successfully process payments.

If the test is successful, you can use this payment gateway for your events going forward.