---
title: How do I connect my iATS Hosted Payments account in raisin?
description: The steps to connect your iATS hosted payments account in raisin
---

[Skip to content](https://knowledgebase.akaraisin.com/en/support/how-to-connect-your-iats-hosted-payments-account-in-raisin#main-content)

[Submit a request ↗](https://knowledgebase.akaraisin.com/en/support/kb-tickets/new?hsLang=en)

[![raisin Logo](https://knowledgebase.akaraisin.com/hs-fs/hubfs/logo_raisin.png?height=40&name=logo_raisin.png)](https://raisinsoftware.org/)

- [Help Centre](https://knowledgebase.akaraisin.com/en/support)

Open main navigation

Close main navigation

- [Help Centre](https://knowledgebase.akaraisin.com/en/support)
- [Submit a request ↗](https://knowledgebase.akaraisin.com/en/support/kb-tickets/new)

 How can we help out?

- There are no suggestions because the search field is empty.

1. [Help Centre](https://knowledgebase.akaraisin.com/en/support?hsLang=en)
2. [Account & General Setup](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en)
3. [Payment](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#payment)

# How do I connect my iATS Hosted Payments account in raisin?

## The steps to connect your iATS 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, iATS**. This allows payment information to be processed directly through iATS without ever going through raisin.

Below are the steps to connect your iATS hosted payments account to raisin

### Create a Process Key in your **iATS** account

Please follow the steps outlined below, to create a Process Key in your **iATS** account.

1. [Login](https://home.iatspayments.com/) to your iATS account.
2. Click the "**Settings**" tab in the main navigation bar. Select "**Change Password**". 
3. Under the **"Manage process key"** area, select **"Create New Process Key"**.
   
   ![Screen Shot 2022-11-11 at 1.06.41 PM](https://knowledgebase.akaraisin.com/hs-fs/hubfs/Screen%20Shot%202022-11-11%20at%201.06.41%20PM.png?width=688&height=612&name=Screen%20Shot%202022-11-11%20at%201.06.41%20PM.png)
4. **Copy down** the code that appears in the **"Process Key"** column. 
   
   ![Screen Shot 2022-11-14 at 12.54.24 PM](https://knowledgebase.akaraisin.com/hs-fs/hubfs/Screen%20Shot%202022-11-14%20at%2012.54.24%20PM.png?width=688&height=122&name=Screen%20Shot%202022-11-14%20at%2012.54.24%20PM.png)

**This Process Key, will be required when you add your iATS account in raisin. **

### **Add your iATS account in raisin**

Using the Process Key you created, you can add your **iATS** account in raisin. The steps are as follows:

1. Navigate to **Manage Payment Accounts** under General Setup.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-43-27-9691-PM.png?width=570&height=272&name=image-png-Jan-23-2025-08-43-27-9691-PM.png)
2. Click Create **New** Payment Account.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-43-51-2065-PM.png?width=838&height=264&name=image-png-Jan-23-2025-08-43-51-2065-PM.png)
3. Establish an Account Name for the new **iATS** Hosted account. This can be anything you like.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-44-46-8745-PM.png?width=553&height=148&name=image-png-Jan-23-2025-08-44-46-8745-PM.png)
4. Choose **"Ticketmaster IATS - Hosted"** from the drop-down list of Payment Gateways.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-45-39-6313-PM.png?width=601&height=176&name=image-png-Jan-23-2025-08-45-39-6313-PM.png)
5. Choose the currency of the gateway(Canadian or US Dollars)
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-46-47-7309-PM.png?width=539&height=199&name=image-png-Jan-23-2025-08-46-47-7309-PM.png)
6. Enter your **Client Code and Password.** You can get these from your iATS account.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-48-11-8671-PM.png?width=535&height=272&name=image-png-Jan-23-2025-08-48-11-8671-PM.png)
7. **Enter in the Process Key you created above.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-49-22-5799-PM.png?width=524&height=262&name=image-png-Jan-23-2025-08-49-22-5799-PM.png)**
8. 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 iATS journal respectively. This can be anything you'd like and will help you identify transactions that came through raisin.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-52-53-9350-PM.png?width=481&height=268&name=image-png-Jan-23-2025-08-52-53-9350-PM.png)
9. Click **Add.
   
   ![](https://knowledgebase.akaraisin.com/hs-fs/hubfs/image-png-Jan-23-2025-08-53-48-3891-PM.png?width=465&height=278&name=image-png-Jan-23-2025-08-53-48-3891-PM.png)**

The styling of Hosted Payment fields for Credit Card Number, Cardholder Name, Expiration Date and CVV Code **comes directly from iATS**, given that it is hosted on their platform. **IATS** has default styling for these fields. Therefore, it will automaticallyinherit the following look and feel:**   

![Screen Shot 2022-11-16 at 3.17.14 PM](https://knowledgebase.akaraisin.com/hs-fs/hubfs/Screen%20Shot%202022-11-16%20at%203.17.14%20PM.png?width=688&height=343&name=Screen%20Shot%202022-11-16%20at%203.17.14%20PM.png)

Please note: raisin cannot make any modifications to the payment form, as this form is hosted directly within iATS.**

### **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.**

**Follow these steps to test your payment gateway**

1. Go to **Events**, and select one of your events, with donations enabled
2. If the event is on **Multi-Pledge, Donations or Ticketing, go to Event Details**, and scroll to Payment Account. If the event is on **Pledge, go to Location Details**, and scroll to the Payment Account.
3. Select to name of the Hosted Payments account you added, to make the event live.
4. Save.
5. Launch the front-end site and make a small donation.
6. Regardless of the result, go to **Reports** \> **Transactions Report** and check the payment status. If it was Failed, then the payment status will indicate [the reasons iATS declined the payment](https://content.iatspayments.com/developers-credit-card-reject-codes-north-america) and may indicate an issue with your account, or that credentials were entered incorrectly. Contact iATS and your raisin Client Experience Manager if this occurs. 
     1. Log in to your iATS account (not in raisin), and check the status of the payment you just submitted.

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

 

- [Account & General Setup](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#main-content)

    - [Organization](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#organization)
    - [Modules](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#modules)
    - [Payment](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#payment)
    - [Shared Content](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#shared-content)
    - [Security Management](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#security-management)
    - [Invoice](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#invoice)
    - [Email](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#email)
- [Event Setup](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#main-content)

    - [Event Details](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#event-details)
    - [Go Live](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#go-live)
    - [Registration Information](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#registration-information)
    - [Sponsorship Items](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#sponsorship-items)
- [Content Management](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#main-content)

    - [Pages](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#pages)
    - [Sections and blocks](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#sections-and-blocks)
    - [Design](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#design)
    - [User Profile Fields](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#user-profile-fields)
    - [Edit Content (Legacy)](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#edit-content-legacy)
- [Message Templates](https://knowledgebase.akaraisin.com/en/support/message-templates?hsLang=en)
- [User Management](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#main-content)

    - [Surveys](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#surveys)
    - [Donors](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#donors)
    - [Participants & Teams](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#participants-teams)
    - [Tickets & Tables](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#tickets-tables)
- [Revenue Management](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#main-content)

    - [Assign Package Codes (Solicitation Codes)](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#assign-package-codes-solicitation-codes)
    - [Offline Pledges](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#offline-pledges)
    - [Payment and fundraising information](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#payment-and-fundraising-information)
    - [Promo Codes](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#promo-codes)
    - [Transactions](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#transactions)
- [Tax Receipts](https://knowledgebase.akaraisin.com/en/support/tax-receipts?hsLang=en#main-content)

    - [Manage](https://knowledgebase.akaraisin.com/en/support/tax-receipts?hsLang=en#manage)
    - [Setup](https://knowledgebase.akaraisin.com/en/support/tax-receipts?hsLang=en#setup)
- [Analytics](https://knowledgebase.akaraisin.com/en/support/analytics?hsLang=en)
- [Reports](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#main-content)

    - [General Questions](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#general-questions)
    - [General Donation](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#general-donation)
    - [Downloads](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#downloads)
    - [Common Reports](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#common-reports)
    - [Pledge / Multi-Pledge](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#pledge-multi-pledge)
- [Export Data](https://knowledgebase.akaraisin.com/en/support/export-data?hsLang=en#main-content)

    - [Flat File](https://knowledgebase.akaraisin.com/en/support/export-data?hsLang=en#flat-file)
- [Integrations](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#main-content)

    - [Google Analytics](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#google-analytics)
    - [Strava](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#strava)
    - [360MatchPro by Double the Donation](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#360matchpro-by-double-the-donation)
    - [Address Complete](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#address-complete)
    - [MailChimp](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#mailchimp)
    - [Live streaming](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#live-streaming)
    - [DonorPerfect](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#donorperfect)
- [Customer Support](https://knowledgebase.akaraisin.com/en/support/customer-support?hsLang=en)

[![Chill listening crop-3](https://knowledgebase.akaraisin.com/hs-fs/hubfs/logo_raisin.png?width=63&height=24&name=logo_raisin.png "Chill listening crop-3")](http://www.akaraisin.com)

The digital fundraising partner to growing non-profits.

Copyright © 2026 raisin Software | [Privacy Policy](https://raisinsoftware.org/privacy-policy/)