Webhooks
Under Webhooks you can find your installed webhooks and add new ones.
A webhook enables web-based notifications to be sent to other applications. For example, transactions and their status can be synchronized with third-party systems such as an e-commerce store, an ERP or an accounting system.
Setup
No webhook setup is necessary for your e-commerce connection. If set up according to instructions, a hidden webhook is already created in the background.
Configuration
Currently, there are three different webhook types. These are Transaction, Subscription and Payout webhooks and are triggered as follows:
Transaction: Always when creating or changing the status of a transaction
Subscription: For important events of Payrexx managed subscriptions
Payout: When creating a new payout from Payrexx.
In addition, some configuration options, are available. Briefly explained here:
Name: Naming of the webhook. This is optional and helps for example with the assignment of the webhook logs
Webhook URL: The webhook data is sent to this URL. This URL must be exactly right!
Try again if an error occurs: There is a possibility that the webhook or its content at the destination URL will trigger an error. With this option setting, the webhook is retransmitted several times in case of an error. We recommend not enabling this option unless required by the target system.
Webhook Content Type: There are various formats that are used in the communication between applications. Payrexx offers the choice between JSON and POST Form Data.
Webhook Error
A Webhook error occurs when the target system rejects the request or the processing of the Webhook triggers an error in the target system. Basically, a webhook error originates with the target system. Sometimes, however, the problem is also due to an incorrect webhook URL or the wrong data type.
Procedure
Depending on the context in which you use webhooks, there are different ways to solve your webhook errors. Below we describe the procedure in three use cases.
If your Webhook error could not be solved, we will be happy to help you within a support ticket.
Logs
In the webhook logs, you will find all webhooks that were sent from your Payrexx account. The logs contain successful as well as failed webhooks.
Developers & Webhooks
Additional information about webhooks, can be found in the corresponding article of the developer documentation:
Last updated