FAQ 🤔

Below is a collection of the questions we get asked more frequently

Do we need contracts with each onramp?

No — Onramper works straight out of the box. However, if you prefer to contract directly with a specific onramp, we can facilitate that for you.

Why are aggregator fees cheaper?

Onramper typically doesn't add fees on top of those offered by onramps. For each transaction, we fetch live quotes from across the ecosystem to ensure your users receive the most crypto. On average, our fee-based routing saves users 2.52%.

How does Onramper monetize?

We are a SaaS business. A small part of revenues come from kickbacks paid by the fiat onramps we aggregate. This kickback comes out of the margin of onramps, as we don't add fees on top of onramp fees. For high-volume clients, we reduce user-fees below what onramps typically charge.

We already have onramps. Is that an issue?

Not at all! The Onramper API easily integrates with your existing onramps. You can maintain your current integrations while adding new ones. Additionally, you can connect webhooks from both new and existing onramps to the Onramper Terminal for comprehensive insights and performance analysis.

How do you reduce KYC friction?

When a transaction occurs, our routing engine quickly assesses your customer’s profile to identify the optimal onramp considering success rates, fees, and ease of transaction completion. For smaller-value transactions, extensive KYC is often not required, allowing for faster and simpler swaps. Repeat users are sent to onramps they are already KYCed with.

We lack the resources to integrate. Is Onramper still right for us?

Yes, limited resources make Onramper an ideal solution. Integration requires about eight lines of code, and we're available to assist throughout the process. Once integrated, Onramper handles all onramp maintenance, saving you time and effort.

Why does my staging API key have the pk_live prefix?

All API keys have the same prefix, and they are scoped differently based on their usage. The key difference between sandbox and production environments is the URL, not the key itself. This consistent prefix simplifies key management while ensuring proper scoping and security.


Integration FAQ

How can we localize currencies and payment methods?

To improve user experience, localizing fiat currency by detecting the user’s country can reduce clicks. This can be done by detecting country based on App Store location or IP address. Based on this, you can display the available default currencies, payment methods and pairs. Use Onramper's Payment Types API to get a list of APMs based on the source (fiat) currency. Prioritize payment methods with the SourceAndDestSupported status in the API response.

Why should we recommend alternative payment methods (APMs) over credit cards?

Recommending country-specific alternative payment methods (APMs) can significantly boost conversion rates. On average, APMs lead to a 132.2% increase in conversions compared to credit card defaults.

Can we reduce the number of screens during the onramp flow?

Yes, you can reduce the number of screens by skipping Onramper’s widget and redirecting users directly to the onramp using the parameter ?skipTxScreen=.

Is it a good idea to route users based on the lowest price?

Routing based solely on price is not recommended. This can lead to:

How can we optimize onramp recommendations?

To provide better onramp recommendations, use Onramper’s Onramp Ranking Engine, which ranks onramps based on price, conversion rate and more! Display this ranked list in your UI. Alternatively, use the onramp with the SuccessRate label from the API to recommend the best converting option.

How can we improve conversion rates for returning users?

Returning users convert nearly 4.8x more when using onramps they’ve previously used, as they are already KYC-verified. To route returning users to their previous onramp, append a unique user ID (UUID) in your Quotes API request. The API will return an onramp with the label SuccessfullyCompleted if the user has previously completed a transaction with that onramp. Display this in your UI to recommend the same onramp to the user.

Anything else?

We are here to help you. If you already have a contact at Onramper, feel free to get in touch with them. If not, you can reach out support team here and we will help you with any question you may have.