Webhook verification

Receive event notifications



Events sent by BCB will always originate from the same IPs below. We recommend filtering these IPs and rejecting events received from other IPs.

EnvironmentInstance TypeIP Addresses
ProductionMain Instance35.197.220.208
SandboxMain Instance34.105.186.34

Verification process

Verify every webhook before you act on it:

  1. Check the source IP. Reject requests that do not come from the address for your environment in the table above.
  2. Check the signature. Every webhook has an X-BCB-SIGNATURE header: an RSA SHA-256 signature of the raw request body, made with BCB's private key. Verify it with BCB's public key, and respond with 401 if it is missing or invalid.
  3. Process the event. Only then parse the JSON body, ignore any duplicate events, and respond with a 2xx status.

See Webhook Signature for BCB's public keys, code examples in TypeScript, Python and Java, and a test case you can use to check your implementation.