Configure IPPay Integration

Overview

This integration allows gaiia to connect with IPPAY for secure and efficient processing of both credit card and bank account (ACH) payments.

This integration must be configured by users with the Admin > Billing Settings permission.

Adding the integration

1. If you don’t already have one, contact IPPAY to set up your account.
2. If not already done during setup, request the following credentials by sending this email to your IPPAY contact:

   Hi there,

   We would like to request the following API credentials:

   HPP Form:

   • MID
   • Security key
   • Customer ID

   API Direct gateway:

   • Terminal ID

   Reporting API:

   • Reporting merchant ID
   • Reporting password

   For the HPP form, please enable support for both ACH and credit card payments.

   Please also whitelist the following IP addresses for gaiia to access IPPAY services:
   3.215.70.188, 3.228.90.246, 3.131.170.31, and 3.14.2.120.

   Best regards,

3. Once you’ve received the credentials, go to the gaiia integrations page.
   Click on Install for the IPPAY integration and enter the requested information.

Confirm the integration works as expected

You'll need to complete the full transaction and refund flow using both payment types: credit card and bank account.

Credit card

1. Create a payment method using a test credit card.
2. Create a payment:
   • Click on Make payment
   • Select the new credit card payment method
   • Enter an amount of $1 or more
3. Verify that the payment appears in your credit card transaction history.
4. Issue a refund in gaiia.
5. Confirm the refund also appears in your credit card history.

Bank account (ACH)

1. Create a bank account payment method (you’ll notice a different form).
2. Create a payment:
   • Click on Make payment
   • Select the new bank account method
   • Enter an amount of $1 or more
3. Wait a few days and verify the payment appears in your bank account.
4. Issue a refund in gaiia.
5. After a few days, confirm that the refund appears in your bank account.