Simulating notifications

Webhooks in sandbox function in the same way as the Production environment, ensuring a seamless transition between testing and live implementations.

IP Whitelisting Requirements

Just like in production, you must whitelist a specific range of IP addresses from which Banking Circle Connect sends webhook notifications. This security measure ensures that notifications are only accepted from legitimate Banking Circle sources.

Webhook Simulator

The sandbox environment provides a dedicated webhook simulator endpoint that allows you to test your webhook implementation without triggering actual events. This is particularly useful for:

  • Validating your webhook endpoint setup
  • Testing your notification handling logic
  • Ensuring proper IP whitelisting configuration

Using the Simulator

The simulator is available exclusively in the sandbox environment via the endpoint:

POST https://sandbox.bankingcircleconnect.com/api/v1/notificationselfservice/clienttest/{id}

When called, this endpoint will:

  • Generate a mocked payment event that matches your subscription
  • Trigger a notification to your configured webhook endpoint
  • Return a 200 response with details about the triggered subscription events

Important: The simulator only triggers the webhook notification - it does not create or modify any underlying resources. For example, when simulating a payment notification, no actual payment is created in the system.

This allows you to safely test your webhook handling without affecting any test data or triggering actual business processes.

20.67.201.6, 20.67.201.16, 20.67.201.23, 20.67.201.40, 20.67.201.48, 20.67.201.53, 20.67.201.72, 20.67.201.99, 20.67.201.117, 20.67.202.197, 20.67.202.200, 20.67.202.212, 20.67.202.220, 20.67.202.248, 20.67.203.10, 20.67.203.20, 20.67.203.26, 20.67.203.39, 20.67.203.47, 20.67.203.61, 20.67.203.66, 20.67.200.198, 20.67.200.210, 20.67.200.229, 20.67.200.248, 20.67.200.252, 20.67.201.3, 20.67.201.36, 20.67.201.50, 20.67.201.85, 20.50.64.11,52.156.253.199, 52.156.253.140, 135.236.114.55, 135.236.114.124