THE IDENTITY
One key, one integration
Partners authenticate with a registered RSA public key. The matching private key stays in your infrastructure. Bullring stores the public key and maps it to your team and store.Required headers
X-Key-Id is public metadata. It selects the public key used for verification.
Store scope
The key is associated with an existing Bullring store integration. Your requests cannot access another store or an unrelated subaccount.Optional IP allowlisting
When registering a partner integration in the dashboard, you can provide exact IPv4 or IPv6 addresses allowed to send requests for that integration.- Leave the list empty to allow requests from any source IP.
- Separate multiple addresses with commas or new lines.
- A request from an address that is not on the list returns
403with codeIP_NOT_ALLOWED. - The allowlist applies to the partner integration and its signing keys.
- CIDR ranges are not accepted; add each exact source address.