Webhooks Configuration

Webhooks is an HTTP endpoint that is used to receive notifications about events that occur in the Ottu system. For example, if a payment is created, Ottu can send a webhook notification to the merchant's server with the details of the payment. The merchant can then use this information to update their systems. Enhance your Ottu experience with our powerful Webhook Configuration. Take advantage of API payloads, SSL certificate verification options, error notifications, and more.

Webhooks Configuration Walkthrough

To access the Webhook Configuration, navigate to Ottu Dashboard > Administration Panel > Webhook > Webhook Config

General

Description of Fields:

• HMAC key:

  This key is used to generate signatures.
• Ignore SSL:

  If checked, the SSL certificate will not be verified when calling the webhook URL.
• Notify on Error:

  If checked, an email will be sent if an error occurs while calling the webhook URL.
• Email List:

  Specify the list of email addresses where the webhook URL error notification should be sent.
• Timeout:

  The amount of time that the Ottu server will wait for a response from the merchant server.

• Retries:

  The number of retry attempts the Ottu server will make to resend the request to the merchant server if the first attempt fails. Note that the Enable retry webhook mechanism option should be checked to activate this feature.

• Backoff factor:

  The amount of time the Ottu server will wait before retrying the request (i.e., the time between two attempts).

Example:

Imagine a scenario where the merchant’s server experiences downtime for 30 seconds. If the timeout is set to 20 seconds, the retries are set to 3, and the backoff factor is set to 5 seconds, then the following will happen: Keep in mind that the merchant’s server will take 30 seconds to respond, and the number of attempts is 3.

• First Try:

1. Ottu's server will send a request to the merchant's server.

2. Ottu's server will wait 20 seconds for a response (timeout = 20), and this attempt will fail.

3. Then Ottu's server will wait 5 seconds for the backoff factor (backoff factor = 5).

Note that the first attempt took 25 seconds.

• Second Try:

1. Ottu's server will retry the request, i.e., send another request.

2. After 5 seconds, the merchant's server will respond since the server downtime will be over (30 seconds), and the request will be successful.

• Version:

  The version of the webhook API.

• Enable webhook notifications:

  If checked, webhook notifications will be activated.

Redirect behavior: The redirect behavior is determined by the webhook URL response to payment events and payment operations.

• If the webhook URL returns a status code of 200, the customer will be redirected to the redirect_url.
• If the webhook URL returns a status code of 201, the customer will be redirected to the Ottu payment summary page.

• If the webhook URL returns any other status code, the customer will be redirected to the Ottu payment summary page. In this case, Ottu can send an email notification if the Enable webhook notifications option is checked.

• Enable retry webhook mechanism:

  If checked, Ottu will retry the request if the first attempt fails. See the example scenario above for further clarity.

• Operations webhook_url:

  The URL where transaction data will be disclosed once an operation transaction flow is triggered. See Operation Notification.

• Enable webhook notifications if transaction initiated from API:

  If checked, Payment Webhooks will be activated even if the transaction is created via the API.

Webhook Plugin Configs

In this tab, the merchant can define the desired webhook behavior for specific plugins.

Description of Fields:

• Webhook plugin:

  The plugin that the webhook works for. See Plugins

• Webhook URL:

  When a payment event or payment operation occurs, Ottu sends an HTTP request to this URL to disclose transactional data.

• Enable transaction state webhook notifications:

  If checked, Payment Notifications will be sent for the defined Notification status.

• Notification status:

  Define the transaction status that will trigger the Payment Webhook, including paid, failed, authorized, and canceled. Review the payment transaction states for more information.
• Delete:

  Deletes the defined plugin webhook configuration.

The Webhook URL specified in the webhook plugin configuration serves as the endpoint for receiving notifications related to both payments and operations. If we provide values for both the Operation webhook_url and the Webhook URL in the plugin configuration, the system will transmit data to both URLs.

Summary

In Ottu, there are two main webhook URLs used for different notification purposes. These URLs differ based on how they are provided and the reasons for the notifications. Here's a detailed breakdown:

Reasons for Notification

For more detailed information on the reasons for notifications, you can refer to the respective sections:

• Payment Notification: This section covers notifications related to payment completion, payment status updates, and other payment-related events. Please refer to Payment Notification.

• Operation Notifications: This section details notifications for post-transaction activities such as refunds, captures, voids, and other operational events. Please refer to Operation Notification.

Ways of Providing Webhook URLs

1. Payment Webhook URL:

   • Checkout API Request Payload:

     • When creating a Checkout request, you can specify the webhook_url directly in the API payload. This parameter should be checked.
   • Webhook Plugin Configuration:

     • You can configure the payment Webhook URL through the Webhook Plugin Configs in the Ottu administration dashboard. This URL will receive payment notifications for all transactions processed by Ottu. The payment notification should be enabled here.

2. Operation Webhook URL:

   • Checkout API Request Payload:

     • Similar to the payment webhook, you can specify the operation webhook_url in the Checkout API request payload. This URL will be used for both payment and operation notifications (such as refunds, captures, and voids). This parameter should be checked
   • Webhook Configuration:

     • The Operations webhook_url can also be configured through the Webhook Configuration section in the Ottu dashboard.

   • Webhook Plugin Configuration:

     • Additionally, you can configure the operation Webhook URL via the Webhook Plugin Configs.

By setting up these webhook URLs correctly, you ensure that your system receives timely and accurate notifications for both payment and operation events, facilitating seamless transaction management and customer service.