Payment
      Back to home
      1. Knowledge Base
      2. Account & General Setup
      3. Payment

      Connecting a Global Payments ECommerce payment account.

      Global Payments is moving to its next-generation payment gateway, Global Payments Ecommerce. New Ecommerce accounts can be created in raisin to establish an integration and accept payments.

      Global Payments has announced its next-generation payment gateway called, Global Payments Ecommerce. As part of initiating the new gateway, Global Payments will retiring their previous Global Transport and products effective June 30, 2022. More details from Global's communication can be found here.

      raisin, in turn, will be supporting Global Ecommerce payment accounts, and deprecating support for the related Transport API as of the June 30, 2022 date.

      To transition for the new gateway, there are three simple steps you'll want to take, and that your Client Experience Manager is happy to support with:

      1. Request your Ecommerce account credentials from Global Payments
      2. Create the Ecommerce account in raisin
      3. Update the Payment Gateway account for any live events in raisin

      Important: For clients with recurring donors, token conversion for any existing gifts will be handled separately by way of Global Payments and raisin's technical teams. Read more below.

      Request Ecommerce account credentials

      Per Global's announcement, you will maintain your existing Merchant ID(s) as your current Global Transport with the new Global Payments Ecommerce platform.To begin your integration to the new Global Payments Ecommerce platform, reach out their integration support team at ca.ecomsupport@globalpay.com. We recommend doing this as soon as possible. The details you will require to connect your new Account in raisin are below.

      Create new Payment Account(s) in raisin

      The new Payment Account(s) should be created to replace your current Transport account on raisin. This can be performed in raisin by a System Administrator from the General Setup tab:

      1. Navigate to Manage Payment Accounts under Revenue Management.
      2. Click Create New Payment Account.
      3. Establish an Account Name for the new Ecommerce account that differentiates it from your existing account.
      4. Choose Global Payments Ecommerce from the drop-down list of Payment Gateways.
      5. Check off the cards you accept.
      6. Choose the currency of the gateway.
      7. From Global, enter your Merchant ID, Global Account ID, and Global Shared Secretimg_kb_global-ecommerce
      8. Establish a Transaction Code Prefix of your preference. The Transaction Code prefix is public facing, and will be part of the Transaction Code and Order ID reported in raisin and your Global journal respectively.
      9. Click Add.

      Depending on your security settings within Global, you may be required to whitelist our IP address to accept payments. Contact your Client Experience Manager for the IP addresses.

      Set Events to your new Global Ecommerce account

      With the new Ecommerce account(s) you've created, you'll then want to switch any Events in raisin using your old Global Payments account to new gateway you've just established.


      To ensure the credentials you've entered are correct, we recommend a quick test first:

      1. Go to Events, and use the handy Copy tool to replicate an existing Event. The copied event will be used for the purposes of making one real payment.
      2. In the copied event Details, scroll to Payment Gateway Account.
      3. Select to name of the Ecommerce account you've created 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 Global declined the payment and may indicate an issue with your account, or that credentials were entered incorrectly. Contact Global and your raisin Client Experience Manager if this occurs.
      7. Log in to your Global Ecommerce account (not in raisin), and check the status of the payment you just submitted.

      If the test is successful, follow these steps to switch all of your Live events to the new Ecommerce account:

      1. Go to the Events tab.
      2. From the Events list, select the Location Details of the Event.
      3. Scroll to Payment Account under Payment & Fundraising Information.
      4. Select to name of the Ecommerce account you've created and tested. This will switch the destination of all new payments going forward.
        Screen Shot 2022-05-19 at 1.23.16 PM
      5. Save.
      6. Repeat for all other Events where your previous Global account was active.

      Important: You will be unable to switch Payment Accounts for events with ongoing recurring donations. See below for instruction on how to migrate these campaigns.

      Transferring recurring donations

      Recurring donations are submitted via secure tokens that are unique to your payment gateway account. For this reason, you will be unable to switch the Payment Account for Events in raisin where there are ongoing recurring gifts.

      Instead, for a seamless transition the Global Payments and raisin technical teams will be securely migrating recurring gifts in waves. This process involves converting your previous Global Transport tokens to the new Ecommerce protocols, and manually set the Payment Gateway Account in raisin to your new Global account.

      To initiate this process, please notify your Client Experience Manager as soon as you have successfully established your new ECommerce account in raisin.