PollarPollar
Core Concepts

Ramp Flow, Step by Step

A ramp provider settles on its own chain, and your app may serve users on another one. This page plays a buy or a sell end to end so you can see how the funds get from one to the other. Pick the chains your app enables in the dashboard, the wallet custody, the currency and the direction: the diagram rebuilds the flow for that combination.

The route shown is a provider that settles USDT on Polygon. When the app does not enable Polygon, Pollar creates a rail wallet for the user there, and Circle's bridge moves the USDC between Polygon and the user's chain. For how routes, quotes and orders work in the API, see Ramps.

Chains enabled in the dashboard
Polygon disabled: the ramp uses a rail wallet.
Wallet custody
Currency
Operation
Source chain
Language
1 / 11
Speed
Message / APISignatureFundsApp gasRail wallet
Sign-in and wallets / step 1 of 11
The user signs in

The SDK creates a key on the device and sends it with the login. That key is the user's credential with the wallet provider: nothing gets signed without it.

Enabled chains: Solana
The 8 chain combinations

Each combination crosses with the 3 custody types in the next table: 24 cases. Custody changes who signs, not which wallets exist.

Enabled chainsWallets created at sign-inPolygon walletDestinations when buying with BOB
NoneNone: a session without a wallet.Not used.None: no routes are offered.
StellarStellar.Rail wallet, created when ordering.USDC on Stellar.
SolanaSolana.Rail wallet, created when ordering.USDC on Solana.
PolygonPolygon.Visible, from sign-in.USDT or USDC on Polygon.
Stellar + SolanaStellar and Solana.Rail wallet, created when ordering.USDC on Stellar and USDC on Solana.
Stellar + PolygonStellar and Polygon.Visible, from sign-in.USDC on Stellar and USDT or USDC on Polygon.
Solana + PolygonSolana and Polygon.Visible, from sign-in.USDC on Solana and USDT or USDC on Polygon.
Stellar + Solana + PolygonStellar, Solana and Polygon.Visible, from sign-in.USDC on Stellar, USDC on Solana and USDT or USDC on Polygon.
Custodial (Pollar)Co-signed (2 of 2)Self-custody (1 of 1)
Where the keys liveIn Pollar's wallet services, encrypted.At the wallet provider, in a vault the user's device and Pollar control together.At the wallet provider, in a vault only the user's device controls.
Who signs a ramp stepPollar, without the user.The device approves first; Pollar checks the transaction and approves second.The device alone. Pollar sends it to the network but cannot sign.
Rail walletPollar creates it when the order is placed.A request to add a Polygon account, which the user approves.Same as co-signed, without Pollar's approval.
RecoveryNot needed.Required before receiving funds on mainnet. The user adds it directly with the wallet provider (passkey or email code); Pollar does not set it.
If the user is offlineThe order moves on by itself.The order waits with the funds in the user's wallet. A pending request expires after 24 h and opens again; the order does not expire while funds sit in the rail wallet.
NetworkTestnet only. On mainnet new wallets are created at the wallet provider.Mainnet and testnet.Mainnet and testnet.
Pollar does not pool users' funds

The ramp provider delivers to the user's own Polygon wallet, and the swap and the burn leave from that wallet. For the mint, Pollar only delivers the message Circle signed and pays the gas: the destination and amount are fixed in it.

If the app enables Polygon later

The existing rail wallet becomes visible, with its balance and history. No new one is created. If the app disables a chain, its wallets become rail wallets and stay the user's.

Funds in transit

If a step fails after the funds arrive (swap or bridge), the balance stays in the user's rail wallet. The widget shows the funds in transit with a button to retry.

Every ramp step is confirmed

With wallets at the wallet provider, ramp steps ask for confirmation one by one, even if the app has an auto-approval window. Gas, reserves and fees are always paid by the app.

Example amounts (127 BOB for 10 USDT). The real rate is the ramp provider's quote.

On this page

No Headings
Was this helpful?