.png)
Use Case: Enable Subscription Event Alerts
You can receive a notification every time a subscription plan is created or changes status by setting up alerts in the Portal. To receive notifications about subscription status changes, you can set up email alerts or web alerts (webhooks) for your account. This tutorial will walk you through the steps required to configure an email or web alert for subscription creation or status change events.
Objective
Create a new notification alert that notifies you when an update to a Merchant’s customer Subscription event occurs.
Audience
Facilitators
Referrers
Merchants
Environment
Portal (Sandbox)
Portal (Production)
Prerequisite
Prerequisite:
You must have a fully boarded Payrix account to perform any of the actions described in the use case guides.
Tips
Tip: 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.
Additional Resources
For more information, see the Payrix Resource Center Portal Guides for Email Alerts page (Merchant)(Referrer)(Facilitator) and Web Alerts page (Merchant)(Referrer)(Facilitator)
Read Setting up Email Alerts for more details about configuring email alert notifications.
Read Setting up Web Alerts (Webhooks) for more details about the web alert system and setup.
Enable Subscription Event Alerts
Enable Email Alerts for a Subscription Event
1. Open the Email Alerts Subscriptions Tab
Step 1: Click EMAIL ALERTS under the Admin category in the left-hand navigation panel to open the Email Alerts page.
Step 2: Click Subscriptions in the tab menu at the top of the page.
2. Create a New Email Alert
Step 1: Locate the Subscription event type in the Subscriptions tab. Choose from the following types:
Subscription Created
Subscription Approved
Subscription Failed
Step 2: Click the MINUS icon on the right-hand side of the Subscription event to activate the alert.
Step 3: Click the TRIANGLE icon to the left of the Subscription event title to open the event type options section.
Step 4: Enter the email address of the alert recipient in the email field.
Warning: 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.
Tip: Use the admin or account manager’s email address to ensure notifications are not missed and that alerts are confidential.
Step 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.
Step 6: Click SAVE in the upper right-hand corner of the section to finish setting up the alert.
Result: The recipients receive an email alert when the specific Subscription event type occurs.
Enable Web Alerts (Webhook Notifications) for a Subscription Event
1. Open the Web Alerts Page
Step 1: Click WEB ALERTS under the Admin category in the left-hand navigation panel to open the Web Alerts page.
Step 2: Click the ADD ALERT button in the upper right-hand corner of the page to open the Add Alert Setup lightbox on the page.
2. Name the New Web Alert
Step 1: Type the name of the new alert in the Name field in the first section of the Add Alert Setup lightbox.
Step 2 (Optional): Type an optional description of the alert in the Description field.
Step 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.
Step 5: Click NEXT in the lower right-hand corner of the lightbox to move to the next section.
Tip: Click PREVIOUS in the lower right hand corner of the lightbox to go back to a previous section at any time.
3. Attach your Endpoints receiving the Web Alert
Step 1: Enter the endpoint in the Endpoint field. The endpoint is the URL address on your server that receives the alert from Payrix.
Step 2 (Optional): Enter the header name and header value in the open fields under the Endpoint field.
Step 3 (Optional): Click ADD ANOTHER ENDPOINT to add additional endpoints. Click the TRASHCAN icon to remove an endpoint.
Step 4: Click NEXT in the lower right-hand corner of the lightbox to move to the next section.
4. Set Subscription Event Web Alert Triggers (Alert Resources)
Step 1: Select Subscriptions from the Resource drop-down menu.
Step 2: Select the type of event that triggers the alert from the Event drop-down menu.
Subscription Created
Subscription Approved
Subscription Failed
Step 3 (Optional): Enter a name and description in the fields below the Resource and Event fields.
Step 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.
Step 5: Click ADD to finish setting up the new web alert.
Result: The new web alert triggers when the resource and event occur.
Next Steps
Once the new alert is enabled, review the following use case guides for additional information on related topics:
Enable Invoice Event Alerts: Create an email or web alert that triggers when an invoice is created or updated by you or one of your users using the Enable Invoice Event Alerts use case.
Enable Chargeback Event Alerts: Create an email or web alert that triggers when a chargeback update, creation, or final decision occurs under your portfolio using the Enable Chargeback Event Alerts use case.
Enable Transaction Event Alerts: Create an email or web alert that triggers when various transaction status changes using the Enable Transaction Event Alerts use case.
Enable Merchant Boarding Event Alerts: Create an email or web alert that triggers when Merchants' boarding status changes using the Enable Merchant Boarding Event Alerts use case.
Enable Disbursement Event Alerts: Create an email or web alert that triggers when withdrawals or negative disbursement events occur or change status using the Enable Disbursement Event Alerts use case.
Enable Change Request Event Alerts: Create an email or web alert that triggers when users in your portfolio update their bank account information manually using the Enable Change Request Event Alerts use case.
Conclusion
Once the alert is enabled, it automatically sends a notification when an invoice event occurs.
References
Click the links or items below to access any of the following pages:
Email Alerts page (Merchant)(Referrer)(Facilitator)
Web Alerts page (Merchant)(Referrer)(Facilitator)