Bank Integration Guide
Three integration levels. Pick the one that fits your bank's timeline and technical depth.
Level 1: API Only (2-4 weeks)
Prerequisites
- A BabyChain wallet address (generated via SDK or API)
- API credentials (contact us to provision)
- Network access to testnet.babyfx.org for sandbox testing
Authentication
All API requests are authenticated with HMAC-SHA256 signatures. You receive a client_id and client_secret during onboarding.
Key Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /v1/balance/{address} | GET | Check 2BABY balance |
| /v1/payment | POST | Create a payment |
| /v1/transaction/{hash} | GET | Verify a transaction |
Create a payment (curl)
curl -X POST https://testnet.babyfx.org/api/v1/payment \ -H "Content-Type: application/json" \ -H "X-Timestamp: 1719063331" \ -H "X-Signature: <computed_hmac>" \ -d '{ "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18", "amount_wei": "1000000000000000000", "memo": "Invoice #1024" }'
Webhook setup
Configure a webhook endpoint to receive real-time payment notifications. See the Webhooks page for signature verification and retry policy.
Level 2: White-Label Wallet (4-8 weeks)
Rebrand BabyWallet as your bank's own mobile app with your logo, colors, and compliance rules.
What gets rebranded
- App icon and splash screen
- Color scheme (matches your bank's brand)
- Default network endpoints (your own RPC)
- Compliance mode defaults (disclosure policy)
- "Powered by BabyChain" footer (required)
SDK setup
iOS and Android SDKs are available to institutional partners. Contact partnerships@babyfx.org for access.
Configuration options
| Option | Description |
|---|---|
| complianceMode | On by default for bank-branded wallets |
| disclosurePolicy | Auto-disclose to bank for transactions over threshold |
| networkEndpoint | Bank's own RPC node or shared BabyChain endpoint |
| features | Enable or disable QR pay, privacy mode, biometric lock |
Deployment checklist
- Register app with Apple and Google under your bank's developer account
- Configure your RPC endpoint
- Set compliance disclosure policy
- Test on testnet with real transaction flows
- Submit for security review
Level 3: Validator Node (2-3 months)
Run a BabyChain validator to participate in consensus, earn rewards, and get direct access to the compliance dashboard.
Hardware requirements
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 4 cores | 8 cores |
| RAM | 16 GB | 32 GB |
| Storage | 500 GB SSD | 1 TB NVMe |
| Network | 100 Mbps | 1 Gbps |
Quick setup
`ash
Install BabyChain node
curl -fsSL https://get.babychain.network | bash
Initialize validator
babychain init --chain-id babychain_2027-1
Configure validator key
babychain keys add validator --keyring-backend file
Join the network
babychain start --p2p-seeds
Validator rewards
Validators earn 2BABY from transaction fees collected in each block. With 1-second block times and PoA finality, rewards are consistent and predictable.
Compliance dashboard access
Validator operators get access to a real-time compliance dashboard with:
- Transaction volume analytics
- Privacy disclosure request queue
- Sanctions screening integration
- Audit log export
Commercial Terms
Contact us for enterprise pricing. Each integration tier has a different commercial model:
| Tier | Pricing Model |
|---|---|
| Level 1 — API Only | Monthly subscription + per-transaction fee |
| Level 2 — White-Label Wallet | Licensing fee + revenue share |
| Level 3 — Validator Node | Setup fee + annual support retainer |
Enterprise pricing includes:
- Dedicated SLAs with uptime guarantees
- Priority support channel with 4-hour response
- Custom compliance configuration
- On-site integration engineering (worldwide)
For a detailed quote, email partnerships@babyfx.org with your expected transaction volume and preferred tier.