Choose Your Integration Path
Oak Network provides payment infrastructure for crowdfunding platforms. Choose the integration path that fits your needs.
Integration Decision Tree
Payment SDK
Use the Payment SDK to collect fiat payments (card, PIX, bank transfer) from backers and pay out campaign creators. Supports automatic conversion to/from crypto.
| Guide | Time | What You'll Learn |
|---|---|---|
| Quickstart | 5 min | Install, authenticate, first API call |
| Complete Guide | 30 min | All services and operations |
| Integration Flow | 45 min | US/Brazil provider flows, subscriptions, webhook events, status reference |
When to Use
- Accepting card payments from backers
- Processing PIX payments (Brazil)
- Paying out creators to bank accounts
- Converting fiat to/from crypto (on-ramp/off-ramp)
- Recurring subscriptions
Supported Providers
| Region | Payment Provider | Crypto Provider | Currencies |
|---|---|---|---|
| United States | Stripe | Bridge | USD ↔ USDC |
| Brazil | PagarMe | N/A | BRL ↔ BRLA |
Contracts SDK
Use the Contracts SDK for crypto-native crowdfunding with on-chain campaign management, treasury contracts, and transparent fund handling.
| Guide | Time | What You'll Learn |
|---|---|---|
| Quickstart | 15 min | Deploy a campaign and accept contributions |
| Complete Guide | 45 min | Full contract architecture, treasury management, settlements |
| Integration Flow | 60 min | Campaign creation, backer interactions, settlement, security, gas optimization |
When to Use
- Crypto-native campaigns (USDC, cUSD)
- On-chain transparency and auditability
- All-or-nothing funding models
- NFT-based contribution receipts
- Decentralized campaign management
Contract Architecture
| Contract | Purpose |
|---|---|
| CampaignInfoFactory | Creates campaign instances |
| CampaignInfo | Stores campaign metadata and state |
| TreasuryFactory | Deploys treasury contracts |
| AllOrNothing | Manages funds with refund-if-failed model |
Hybrid Approach
Combine both SDKs: use the Payment SDK to collect fiat payments, then settle funds on-chain using smart contracts.
Hybrid Flow
When to Use
- Accepting fiat payments but settling funds on-chain
- Providing on-chain transparency while supporting traditional payment methods
- Platforms transitioning from fiat-only to crypto-enabled
- Campaigns that want blockchain auditability with familiar checkout experiences
Benefits
- Familiar payment methods for backers (card, PIX)
- On-chain transparency for campaign funds
- Decentralized settlement and refunds
Quick Comparison
| Feature | Payment SDK | Contracts SDK |
|---|---|---|
| Payment Methods | Card, PIX, Bank Transfer | USDC, cUSD, ERC-20 |
| KYC Required | Yes (for creators) | No |
| Settlement | Off-chain (provider) | On-chain (smart contract) |
| Refunds | Manual via API | Automatic if campaign fails |
| Transparency | Provider dashboard | Blockchain explorer |
| Best For | Traditional platforms | Crypto-native platforms |
Next Steps
Choose your path and get started:
- Payment SDK Quickstart — Fastest way to integrate fiat payments
- Payment SDK Overview — All services and operations
- Payment SDK Integration Flow — US/Brazil provider flows, subscriptions, webhook events
- Contracts SDK Quickstart — Deploy your first on-chain campaign
- Contracts SDK Overview — Full contract architecture
- Contracts SDK Integration Flow — Campaign creation, backer interactions, settlement