Partner Transfers
Partner transfers allow Bankroll users to transfer their reward points to your platform. When a user initiates a transfer, Bankroll sends your platform a webhook. Your platform processes the transfer and sends a confirmation callback.How It Works
User initiates transfer
A Bankroll user chooses to transfer points to your platform. Bankroll validates the user has sufficient balance, deducts the points, and creates a transfer record.
Bankroll sends webhook
Bankroll delivers a signed
transfer.created webhook to your configured endpoint. The payload includes the transfer amount, the user’s external ID on your platform, and an HMAC signature.Your platform processes the transfer
Your platform receives the webhook, verifies the signature, identifies the user, and decides whether to accept or refuse the transfer.
Your platform sends confirmation
Your platform sends a signed confirmation callback to Bankroll indicating whether the transfer was accepted or refused. If refused, the user’s points are refunded.
Partner Portal
The Partner Portal is where you manage your integration. Use it to:- Configure your webhook endpoint URL
- View your shared secret key
- Monitor transfer history and status
- View your account balance and payouts
Prerequisites
Before integrating, you’ll need:- A partner account on the Partner Portal
- A shared secret key (found in the Partner Portal) for HMAC signature verification
- A webhook endpoint on your platform to receive transfer notifications
- The Bankroll API base URL for sending confirmation callbacks
Transfer Amounts
Transfer amounts are specified inusdAmountCents — US dollar cents as an integer. For example, 500 represents 1.00).
User Identity
Each webhook includesexternalId and externalName fields. These correspond to the user’s identity on your platform, established when the user linked their Bankroll and partner accounts.