Ramp Network | Avalanche Builder Hub

Overview

Ramp Network is a fiat-to-crypto infrastructure provider that lets users purchase and sell cryptocurrencies directly within blockchain applications. Ramp handles regulatory compliance and offers on-ramp and off-ramp widgets that integrate with minimal developer effort. It supports multiple payment methods across 150+ countries and provides a customizable widget that matches your application's design.

Features

Global Coverage: Available in 150+ countries with localized payment methods and support for multiple currencies.
Diverse Payment Options: Bank transfers, credit/debit cards, Apple Pay, Google Pay, and region-specific payment methods.
Full Off-Ramp Solution: Complete selling experience allowing users to convert crypto back to fiat with direct bank deposits.
Customizable Widget: White-labeled solution that can be styled to match your application's branding.
Low Integration Effort: Simple SDK integration requiring just a few lines of code.
Multi-Platform Support: Web SDK, React SDK, and mobile SDKs for iOS and Android.
Built-in Compliance: KYC and AML processes that meet regulatory requirements across jurisdictions.
Competitive Fees: Transparent fee structure with some of the lowest rates in the industry.
Developer Tools: Webhooks, callbacks, and detailed documentation for integration.
Advanced Purchase Flows: Support for automatic purchases and recurring purchases.

Getting Started

To integrate Ramp:

Create an Account: Register on the Ramp Developer Dashboard to get your API key.
Install the SDK: For web applications, add the Ramp SDK to your project:
```
npm install @ramp-network/ramp-instant-sdk
```

Initialize the On-Ramp Widget: Implement the widget in your application:

import { RampInstantSDK } from '@ramp-network/ramp-instant-sdk';

const ramp = new RampInstantSDK({
  hostAppName: 'Your App Name',
  hostLogoUrl: 'https://yourdomain.com/logo.png',
  swapAsset: 'AVAX',
  swapAmount: '100000000000000000', // Optional, in wei
  userAddress: '0x...', // User's wallet address
  hostApiKey: 'YOUR_API_KEY',
  variant: 'auto', // or 'desktop', 'mobile', 'embedded'
  webhookStatusUrl: 'https://your-webhook-endpoint.com', // Optional
  defaultFlow: 'ONRAMP', // or 'OFFRAMP'
});

ramp.show();

Implement Off-Ramp (if needed):

import { RampInstantSDK } from '@ramp-network/ramp-instant-sdk';

const ramp = new RampInstantSDK({
  hostAppName: 'Your App Name',
  hostLogoUrl: 'https://yourdomain.com/logo.png',
  swapAsset: 'AVAX',
  userAddress: '0x...', // User's wallet address
  hostApiKey: 'YOUR_API_KEY',
  variant: 'auto',
  defaultFlow: 'OFFRAMP',
});

ramp.show();

Handle Events: Listen for purchase events:

ramp.on('PURCHASE_CREATED', (event) => {
  console.log(`User started purchase: ${event.purchase.id}`);
});

ramp.on('PURCHASE_SUCCESSFUL', (event) => {
  console.log(`Purchase successful: ${event.purchase.id}`);
});

ramp.on('WIDGET_CLOSE', () => {
  console.log('Widget closed');
});

Test in Sandbox: Use the sandbox environment to test your integration before going live:

const ramp = new RampInstantSDK({
  // ...your configuration
  url: 'https://ri-widget-staging.firebaseapp.com/', // Use staging environment
});

Documentation

For more details, visit the Ramp Documentation.

Use Cases

Crypto Wallets: Let users purchase crypto within your wallet application and cash out to bank accounts.

DeFi Platforms: Provide entry and exit points for users to acquire and liquidate tokens for DeFi protocols.

NFT Marketplaces: Allow direct purchase of NFTs with fiat.

Blockchain Games: Let players purchase in-game tokens or assets without needing a crypto exchange.

Enterprise Solutions: Compliant on/off-ramp solution for corporate blockchain applications.

Pricing

Ramp operates on a transaction fee model:

Standard Fee Range: 0.49% to 2.9% per transaction, depending on payment method and region
Volume Discounts: Available for applications with high transaction volumes
Revenue Sharing: Partnership opportunities for qualified integrators
No Monthly Fees: Pay only for processed transactions

For specific pricing details and potential custom arrangements, contact Ramp's sales team.

Is this guide helpful?