Skip to main content

​
Partner API

Bankroll exposes a small HTTPS API for partner integrations. For partner transfers, you use this API to send a final confirmation back to Bankroll after you process a transfer.created webhook.

​
Base URL

The production Partner API base URL is: 
https://api.joinbankroll.com
If you store this in your own server-side configuration, use any variable name that fits your integration.
Your shared secret key comes from the Partner Portal. In these docs, examples refer to that value as BANKROLL_PARTNER_SECRET_KEY.

​
API Conventions

  • Use HTTPS
  • Send JSON requests with Content-Type: application/json
  • Sign request payloads with your shared secret key
  • Treat this as a server-to-server API, not a browser integration
  • Handle non-2xx responses as failures and retry safely from your side when appropriate

​
Authentication

Partner API requests are authenticated with an HMAC-SHA256 signature using the same shared secret key you use for webhook verification. See Signature Verification for the signing rules and reference implementations.

​
Current Transfer Endpoint

MethodPathPurpose
POST/api/webhooks/partner-transfer-confirmationsSend the final outcome for a partner transfer
For the full request and response contract, see Confirmation Callback.