Developer-First API & SDKs

One RESTful API to access every payment method, currency, and feature BetFlow offers. SDKs for 8 languages, interactive docs, and a full sandbox environment.

Official SDKs & Libraries

Node.js
Python
PHP
Ruby
Java
Go
.NET
React
Quick Start

Start Processing Bets in Minutes

Our API is designed to be intuitive and consistent. Create a deposit with a single POST request. Every endpoint follows the same patterns, so if you learn one, you know them all.

RESTful design with predictable resource-oriented URLs
JSON request and response bodies throughout
Standard HTTP status codes and error format
Comprehensive request validation with clear error messages
Built-in pagination, filtering, and sorting
View Full DocsOpen Sandbox
create-deposit.js
Node.js
// Create a bet deposit via BetFlow API
2const response = await fetch('https://api.betflow.io/v1/deposits', {
3  method: 'POST',
4  headers: {
5    'Authorization': 'Bearer sk_live_9a8b7c6d5e4f3g2h1i',
6    'Content-Type': 'application/json',
7    'X-Idempotency-Key': 'dep_abc123_unique'
8  },
9  body: JSON.stringify({
10    amount: 15000,           // $150.00 in cents
11    currency: 'USD',
12    player_id: 'player_8x92k',
13    payment_method: 'card',
14    metadata: {
15      bet_type: 'pre-match',
16      sport: 'football',
17      event_id: 'evt_nfl_2026_wk7_001'
18    },
19    return_url: 'https://yoursportsbook.com/deposit/success',
20    webhook_url: 'https://yoursportsbook.com/webhooks/betflow'
21  })
22});
23
24const deposit = await response.json();
// {
//   id: "dep_1a2b3c4d5e",
//   status: "pending",
//   checkout_url: "https://checkout.betflow.io/dep_1a2b3c...",
//   expires_at: "2026-02-15T12:30:00Z"
// }
API Reference

Clean, Consistent Endpoints

Every resource follows the same RESTful conventions. If you know how to create a deposit, you already know how to create a payout.

POST/v1/deposits
GET/v1/deposits/:id
POST/v1/payouts
GET/v1/payouts/:id
POST/v1/refunds
GET/v1/transactions
POST/v1/customers
GET/v1/balance
Developer Experience

Built by Developers, for Developers

We obsess over DX. Every feature is designed to reduce integration time and make your payment code a joy to maintain.

Real-Time Webhooks

Receive instant notifications for every payment event: deposits, payouts, chargebacks, and status changes. Retry logic with exponential backoff ensures you never miss an event.

Full Sandbox Environment

Test every integration scenario in our sandbox with simulated payment flows, configurable decline reasons, and mock webhooks. Switch to production with a single API key change.

API Versioning

Non-breaking changes are backward compatible. Major versions are supported for 24 months with clear migration guides. You control when to upgrade, never forced.

Idempotent Requests

Every mutating endpoint supports idempotency keys. Safely retry failed requests without risk of duplicate charges, double payouts, or inconsistent state.

Interactive API Docs

OpenAPI 3.0 specification with interactive documentation. Try endpoints directly from the docs, view request/response examples, and generate client code automatically.

Rate Limiting & Monitoring

Generous rate limits with clear headers showing remaining quota. Real-time API metrics dashboard tracks request volume, latency, and error rates across all your integrations.

Integration Path

From Zero to Live in 48 Hours

01
5 min

Get API Keys

Sign up and receive your sandbox API keys instantly. No approval needed to start testing.

02
1-2 hours

Integrate & Test

Use our SDKs or raw REST API. Test deposits, payouts, and webhooks in the sandbox.

03
24 hours

Go Through Review

Submit your integration for review. Our team verifies your webhook handling and error recovery.

04
Instant

Go Live

Receive your production API keys and start processing real bet deposits immediately.

Start Building With BetFlow

Get your sandbox API keys in seconds. Full documentation, code examples, and dedicated integration support at every step.

Get API Keys FreeRead the Docs

Free sandbox access. No credit card required. Upgrade when you are ready to go live.