Use Case: Enable Transaction Event Alerts

Prev Next

You can create an alert that notifies you every time a transaction is created or changes status. To receive notifications about transactions associated with your account, you can set up email alerts or web alerts (also known as webhooks) in the Portal. This tutorial shows you how to configure an email or web alert for transaction creation or status change events.

Audience: Partner, Merchant

Enable Transaction Event Alerts

Ensure that you complete the prerequisites and all steps in a section to enable that alert type.

Note

By default, all custom email and web alerts are disabled. The platform provides a set of default email alerts when a merchant is boarded to cover critical notifications. To learn more about boarding alerts, see the Enable Merchant Boarding Alerts use case.

Prerequisites

Before attempting this tutorial, you must:

Enable Email Alerts for a Transaction Event

Complete all steps in the following sections.

Open the Email Alerts Transactions Tab

  1. Click Email Alerts under the Admin category in the left navigation panel to open the Email Alerts page.

  2. Click the Transactions tab at the top of the page.

Create a New Email Alert

  1. Locate the transaction event type on the Transactions tab. Choose from the following types:

    • Transaction Created

    • Transaction Approved

    • Transaction Failed

    • Transaction Captured

    • Transaction Settled

    • Transaction Returned

    • Transaction eCheck Funded

    • Transaction Delayed Funding

    • Terminal Transaction Created

    • Terminal Transaction Approved

    • Terminal Transaction Failed

  2. Click the switch on the right side of the transaction event to activate the alert. When not subscribed, the switch will display a minus symbol. When subscribed, the switch will display a check.

  3. Click the Triangle icon to the left of the transaction event title to open the event type options section.

  4. Enter the email address of the alert recipient in the email field.

    Important!

    Email alerts are not sent to a newly provided email address until it is verified. You can verify a new email address by following the instructions in the initial enrollment email sent to the user.

  5. (Optional) Click the Plus icon to add fields for additional recipients and enter their email addresses. Click the Minus icon to remove email recipients.

  6. Click SAVE in the upper-right corner of the section to finish setting up the alert.

Result: The recipients receive an email alert when the specific transaction event type occurs.

Enable Web Alerts (Webhook Notifications) for a Transaction Event

Complete all steps in the following sections.

Open the Web Alerts Page

  1. Click Web Alerts under the Admin category in the left navigation panel to open the Web Alerts page.

  2. Click ADD ALERT in the upper-right corner of the page to open the Add Alert dialog on the page.

Name the New Web Alert

  1. Enter the name of the new alert in the Name field in the first section of the Add Alert Setup dialog.

  2. (Optional) Enter an optional description of the alert in the Description field.

  3. (Optional) Click Advanced Options to enter information about the login ID, Team, partition, or Division associated with the alert.

Tip

You can enter the optional advanced options during any step of the setup process.

  1. Click Next in the lower-right corner of the dialog to move to the next section.

Attach your Endpoints Receiving the Web Alert

  1. Enter the endpoint in the Endpoint field. The endpoint is the URL address on your server that receives the alert from Payrix Pro.

  2. (Optional) Enter the header name and header value in the open fields under the Endpoint field.

  3. (Optional) Click Add Another Endpoint to add additional endpoints. Click the Trashcan icon to remove an endpoint.

  4. Click Next in the lower-right corner of the dialog to move to the next section.

Set Transaction Event Web Alert Triggers (Alert Resources)

  1. From the Resource dropdown, select Txns for card-not-present payments or TerminalTxns for card-present payments.

  2. Select the type of event that triggers the alert from the Event dropdown menu.

    • Transaction Created

    • Transaction Approved

    • Transaction Failed

    • Transaction Captured

    • Transaction Settled

    • Transaction Returned

    • Transaction Echeck Funded

    • Terminal Transaction Created

    • Terminal Transaction Approved

    • Terminal Transaction Failed

  3. (Optional) Enter a name and description in the fields below the Resource and Event fields.

  4. (Optional) Click Add Another Trigger to add additional alert triggers. Remove a trigger by clicking the Trashcan icon to the right of the trigger.

  5. Click Add to finish setting up the new web alert.

Result: The web alert automatically triggers when the specific transaction event occurs.

Next Steps

After enabling the transaction alert, review the following guides on enabling other alerts: