Configure Authorize.net Integration

Overview

This integration allows gaiia to connect with your Authorize.net account to process credit card payments directly from the platform.

Once configured, admins will be able to collect payments, issue refunds, and view payment statuses directly within the account interface.

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

Adding the integration

1. If you don’t already have one, create an Authorize.net account.
2. In Authorize.net, locate and send the following keys to gaiia:
   • API Login ID
     Account > Settings > Security Settings > General Security Settings > API Credentials and Keys
   • Transaction Key
     If you haven’t saved your previous key, you’ll need to generate a new one in the same section.
   • Client Key
     Account > Settings > Security Settings > General Security Settings > Manage Public Client Key

   • Webhook
     Account > Settings > API Credentials & Keys > New Signature KeySave the webhhok signature key for later

     If you have already generated a signature key in the past, a date will be shown under “Signature Key Last Obtained”. You can reuse it if needed.

     Make sure to select New Signature Key, not the “Change” option, to avoid conflicts.

     

Setting up the webhook

Step 1: Create the webhook in Authorize.net

1. Go to Settings > Webhooks
2. Click on Add Endpoint

Use the following configuration:

• Name: gaiia webhook
• Endpoint URL:
  Your Endpoint URL will be visible and available to copy once the Authorize.net integration is installed. It looks like: https://webhooks.gaiia.systems/authorize-net/{unique-id}/{unique-id}
• Status: Active
• Events: All events

Replace {billingSettingsId} with the correct UUID for your instance. To find it:
Go to Settings > Billing > Select Currency > Other settings, then locate the field named Billing settings ID.
Copy that UUID and paste it into the URL in place of {billingSettingsId}.

gaiia will confirm the full URL with you if needed. We recommend setting the webhook to Inactive at first so we can confirm the configuration before activating.

You do not need to create a webhook for Authorize in the Settings > Webhooks. Turning on this integration will provide a dedicated webhook specifically for this integration.

If you are testing it yourself, make sure to turn it back to active once you have completed your tests.

Step 2: Add the signature key to gaiia

Use all the keys from the integration's field when configuring the Authorize.net integration to add it to gaiia.

Confirm the integration works as expected

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

For test card numbers and other testing tools, visit: Authorize.net Testing Guide