Managing Authorize.net Module

This manual explains how to configure, manage, and set up webhooks for the Authorize.net payment module after it has been purchased and installed.

Follow the steps below to complete the setup.

1) Accessing the Module Settings

1. Navigate to Payment → Online in the admin area.
2. Locate Authorize.net module using the quick search.
3. Click Edit next to the module.

2) Settings Section

In the Settings section, you can configure the following options:

• Enable the Module: Turn the Authorize.net payment gateway on or off.
• API Credentials: View your API Login and API Transaction Key generated in your Authorize.net account.
• Select Transaction Type: Choose between authCaptureTransaction or authOnlyTransaction
• Order Status Settings:
  • Define the order status before payment.
  • Set the status for completed orders.
• Payment Zone: Select the region where Authorize.net will be available.
• Transaction Server: Choose Live or Test mode.
• Payment Page Customization: Configure the background color for the payment page.
• Display Order: Set the display priority among other payment methods. A lower number results in higher priority.
  

3) Restrictions Section

Use the Restrictions section to customize module availability:

• Customer Groups, Countries, Pages: Choose which customer groups, countries, and website pages can use this payment method.
• Module Name Customization: Set a custom name for the module on both the frontend and backend, and adjust it for different languages.

After making any changes, click Update to save your customizations.

4) Setting Up Webhooks for Authorize.net

To ensure proper transaction handling, set up a webhook in your Authorize.net account.

1. Go to your Authorize.net account and open Settings.

2. Click the Webhooks link.

3. Click Add Endpoint.

5) Configuring the Webhook Endpoint

• In the Endpoint Editor, enter the following:
  • Name: Provide a name for your webhook.
  • Endpoint URL: Enter your website’s callback URL (e.g., https://www.yourwebsite.com/callback/webhooks.payment.authorizenet_accept_hosted).
  • Status: Set to Active.
• In the Select Events section, choose Payment Events and enable the following options:
  • net.authorize.payment.authcapture.created
  • net.authorize.payment.authorization.created
  • net.authorize.payment.capture.created

• Click Save to finalize the webhook setup.

6) Handling Signature Key Errors

If you encounter the error:

“Please generate a signature key from the Merchant/Partner interface to create a webhook”, follow these steps:

1. Log in to your Authorize.net account.

2. Go to API Credentials & Keys.

3. Toggle to enable the New Signature Key option.

4. Leave Disable Old Signature Key Immediately unchecked.

5. Click Submit to generate the new key.

Your signature key will now be updated, and the webhook endpoint will function correctly.

7) Editing Existing Webhooks

If you already have existing webhooks:

1. Click Edit in the Webhooks section.
2. Open the existing endpoint.
3. Ensure all required Payment Events options are enabled.

Your Authorize.net module is now properly configured, and webhook handling is set up for reliable transaction processing.