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.
| Environment | Instance Type | IP Addresses |
|---|---|---|
| Production | Main Instance | 35.197.220.208 |
| Sandbox | Main Instance | 34.105.186.34 |
Verification process
Verify every webhook before you act on it:
- Check the source IP. Reject requests that do not come from the address for your environment in the table above.
- Check the signature. Every webhook has an
X-BCB-SIGNATUREheader: 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 with401if it is missing or invalid. - Process the event. Only then parse the JSON body, ignore any duplicate events, and respond with a
2xxstatus.
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.
Updated 17 days ago