Skip to main content

​
Supported Chains

​
Architecture

RebelFi is the orchestration layer between your platform and banking infrastructure. You talk only to our API — we handle KYB, account issuance, conversion, and delivery.

Your Platform

Calls the RebelFi API to create recipients, provision accounts, query transactions, and receive webhook events

RebelFi

Orchestrates KYB, account issuance, conversion tracking, and event delivery

Banking Infrastructure

Handles virtual bank accounts, USD receipt, and conversion
Your Platform ⟷ RebelFi ⟷ Banking Infrastructure — connected via API + webhooks at each layer. You talk only to RebelFi.

​
Data Flow

​
On-Ramp (USD → USDC/USDT)

When a payer sends USD to a recipient’s virtual bank account, the funds are automatically converted to the configured stablecoin (USDC or USDT) and delivered to the designated wallet.

​
Off-Ramp (USDC/USDT → USD)

When stablecoins are sent to an off-ramp account’s deposit address, the funds are converted to USD and delivered to the configured bank account.

​
Fee Model

A percentage-based fee is deducted from each transaction before delivery. The fee is expressed in basis points (bps) and applies to both on-ramp and off-ramp. Example — $50,000 transaction at 25 bps total fee: Fees are deducted automatically — no invoicing required.

​
Payment Rails

Each ramp account is created with a specific payment rail: You select the rail when creating each on-ramp or off-ramp account.

​
Wallet Model

Each ramp account is bound to a specific wallet:
  • On-ramp accounts have a destination wallet — where USDC/USDT is delivered
  • Off-ramp accounts have a source wallet — where USDC/USDT is sent from
A single recipient can have multiple on-ramp and off-ramp accounts, each targeting different wallets, assets, or networks.

​
Recipient Lifecycle

  1. You create a recipient via POST /v1/ramp/recipients (optionally with address)
  2. RebelFi returns a hosted KYB URL
  3. The recipient completes the KYB form
  4. On approval, RebelFi sends a customer.approved webhook
  5. You create on-ramp and/or off-ramp accounts for the recipient
Accounts are not auto-created — you explicitly create them after KYB approval. This gives you full control over which recipients get which account types.

​
Transaction Lifecycle

Once a recipient has an active account, transactions flow through these states: RebelFi sends webhook events on every state change so you can track progress in real time.