Notifications and reports overview

Payabli has a notifications engine that lets you create notifications for various events using different communication channels: email, phone (SMS) and web (webhooks). The engine also lets you autogenerate reports and send them via email or webhook.

Notifications

Get near-instant notifications via email, SMS, or webhooks for important events like new payment disputes, merchant activations, fraud alerts, approved transactions, settlement history, vendor payouts, and more. Use webhooks with notifications to get real-time updates and automate operations based on key those key events.

An event alerts you when an action has been completed. When you create a notification for an event, Payabli adds a notification to the notification queue within 5 minutes of the event trigger. The notification engine sends the notification’s information to the target via the channel you configure, either web (webhooks), SMS, or email. The information provided with each notification varies by type.

In the following tables:

• The Event column is the event’s canonical name, and the eventType value you pass to the notification API.
• The Trigger column describes what triggers the event.
• The Name in Portal column is the event’s name on the Portal’s notification settings page.
• The Payload column links to the event’s payload in the webhooks reference.

Pay In events

Payments

Transactions and batches

Transfers

Invoices

Subscriptions

Accounts

Pay Out events

Transactions

Settlements

Batches

Funds

Cards

Bills

Vendors

Subscriptions

Accounts

Pay Ops events

Boarding

Merchants

Disputes and chargebacks

Fraud and risk

Files and reports

Routing

For email and SMS methods, The notification includes only the notification content in the email body or in the text for SMS.

Set up and receive events using Web (webhooks)

For webhook notifications, Payabli offers flexibility so you can build and use the notifications as needed.

How webhook delivery works

Here’s the lifecycle of a webhook notification, from event trigger to delivery (or manual retry):

The web notifications are sent to the target URL via HTTP POST. When you create the notification, specify any custom headers or fields to submit with the event in the request. The notification uses standard HTTPS ports: 80, 443, 8080, or 4443.

If needed, you can include an Authorization header for your webhook server in the field webHeaderParameter in the content object. For example, if your webhook server requires basic authorization and your key is AD4566F3S2T76901, then your request would look like this:

1
{
2
  "ownerId": 20,
3
  "ownerType": 0,
4
  "method": "web",
5
  "frequency": "untilcancelled",
6
  "target": "https://mywebhook.domain.com/entrypoint",
7
  "content": {
8
    "eventType": "approvedpayment",
9
    "webHeaderParameters":[
10
    {"key":"Authorization","value":"Basic AD4566F3S2T76901"}
11
    ]
12
  }
13
}

You can also send any other variable in the body with some custom data using the field internalData in the content object:

1
{
2
  "ownerId": 20,
3
  "ownerType": 0,
4
  "method": "web",
5
  "frequency": "untilcancelled",
6
  "target": "https://mywebhook.domain.com/entrypoint",
7
  "content": {
8
    "eventType": "approvedpayment",
9
    "webHeaderParameters":[
10
    {"key":"Authorization","value":"Basic AD4566F3S2T76901"}
11
    ],
12
    "internalData":[
13
    {"key":"myData1","value":"Value1"},
14
    {"key":"myData2","value":"Value2"}
15
    ]
16
  }
17
}

IP addresses for webhook requests

Payabli sends webhook requests from specific IP addresses depending on the environment. If your server blocks incoming requests from unknown sources, add the following IP addresses to your server’s allowlist:

• 52.3.204.115 (sandbox)
• 54.166.54.170 (production)

Retry logic

If sending a webhook fails, Payabli retries the webhook POST 2 times in 5-minute intervals. If the request fails after 2 retries, you can manually resend the failed webhook notification via the API. Follow the steps below to manually resend a failed webhook notification:

Send a success response

Your webhook server must send a success HTTP response code (example: 200) when the payload is successfully received. If you send nothing, or send an error response code (example: 401), Payabli assumes it has failed and the retry logic causes the payload to be sent several times.

Automated reports

Automated reporting lets you gather critical reports without manually filtering and exporting the data. Get automated daily, weekly, and monthly report for daily sales, ACH returns, settlements, and more. You can send these reports via email or via webhook.

The notification engine lets you schedule autogenerated reports with different frequencies: “daily”, “weekly”, “biweekly”, “monthly”, “quarterly”, “semiannually”, “annually”. The reports are sent to the target (destination) using either report-email or report-web where the expected targets are email address or a URL.

For method report-email the report is attached to an email. For the method report-web the file is sent via HTTP POST as “multipart/form-data” and in the field file. Like with events, you can specify custom headers and internal data to be passed to your application in the HTTP request.

Both report methods use the predefined eventType value Report instead of one of the event names listed above.

You can generate the files in CSV, XLSX, and JSON format.

This example creates a daily transaction report and sends it via email:

1
{
2
  "ownerId": 20,
3
  "ownerType": 0,
4
  "method": "report-email",
5
  "frequency": "daily",
6
  "target": "myemail@myDomain.com",
7
  "content": {
8
      "fileFormat":"csv",
9
      "reportName":"Transaction"
10
  }
11
}

Notification status

When you create or manage a notification or autogenerated report via the API, you can enable or disable it with the status parameter. Setting a notification to Inactive disables it, and setting it to Active enables it.

Related resources

See these related resources to help you get the most out of Payabli.