Developer documentation
HomeLogin
Enterprise API
Enterprise API
  • Authentication
    • Generate a private and a public certificate
    • Create a JWT token using your private key
  • Webhooks
  • Payment methods
    • Openbanking recurring payments
    • Openbanking payments
    • Card not present card payments
  • API reference
    • Payments
    • Payment methods
    • Customers
    • Settlements
    • Profiles
    • Specification
Powered by GitBook
On this page
  • Webhooks
  • Registering webhooks
  • Handling Webhooks Requests

Was this helpful?

Webhooks

Webhooks

We utilize two distinct webhooks in our system:

  1. Payment Webhook: This webhook triggers when there is a modification in payment information (i.e. state change).

  2. Customer Payment Methods Changed Webhook: This webhook triggers when there is a change in customer payment methods (i.e. state change).

Registering webhooks

  1. Supply the webhook URL in your account or to your account manager.

  2. Webhooks are activated for all subsequent changed to these resources.

Handling Webhooks Requests

Since the webhook calls are not authenticated, customers need to take the following steps:

  • Extract the id query parameter from the incoming webhook request.

  • Use this id to request the associated resource from our backend for verification and processing.

By following these steps, customers can ensure they are accurately responding to the webhook notifications and updating their records accordingly.

Important Note on Response Codes

Webhooks must always return a 2xx status code. Failing to do so will trigger our retry policy, where we will attempt to resend the webhook using varying retry techniques.

PreviousCreate a JWT token using your private keyNextPayment methods

Last updated 6 months ago

Was this helpful?