Mercuryo Module

Fiat-to-crypto on-ramp and crypto-to-fiat off-ramp functionality through Mercuryo’s payment gateway, offering seamless crypto purchases with multiple payment methods.

Overview

The Mercuryo module integrates with Mercuryo’s payment infrastructure to provide fiat gateway functionality. It enables seamless conversion between fiat currencies and cryptocurrencies through an intuitive interface with real-time exchange rates.

On-Ramp (Buy Crypto)

• Fiat to crypto conversion
• Multiple currencies (USD, EUR, GBP)
• Real-time rates & transparent fees
• Instant & bank transfer options

Off-Ramp (Sell Crypto)

• Crypto to fiat conversion
• Fast settlement times
• Competitive exchange rates
• Multiple withdrawal options

Payment Methods

• Credit/Debit Cards (Visa, Mastercard, Amex)
• Apple Pay (iOS)
• Bank transfers
• 3D Secure authentication

User Experience

• Tab-based interface
• Real-time calculations
• Platform-optimized design
• Transaction summaries

Module Structure

src/modules/mercuryo/
├── index.ts                    # Main exports
├── screens/
│   └── MercuryoScreen.tsx     # Main Mercuryo interface
└── README.md                   # Documentation

Payment Methods & Fees

Payment Methods

Method	Platforms	Fee	Processing Time
Credit/Debit Card	iOS, Android	2.5%	Instant
Apple Pay	iOS only	1.8%	Instant
Bank Transfer	iOS, Android	1.0%	1-3 business days

Method	Platforms	Fee	Processing Time
Credit/Debit Card	iOS, Android	2.5%	Instant
Apple Pay	iOS only	1.8%	Instant
Bank Transfer	iOS, Android	1.0%	1-3 business days

const filteredPaymentMethods = paymentMethods.filter(method =>
  !(method.appleOnly && Platform.OS !== 'ios')
);

Supported Assets

Show Fiat Currencies

Currency	Symbol	Region
USD	$	United States Dollar
EUR	€	Euro
GBP	£	British Pound Sterling

Show Cryptocurrencies

Token	Symbol	Description
SOL	SOL	Native Solana token
USDC	USDC	USD Coin on Solana
BONK	BONK	Solana meme token

Transaction Flow

On-Ramp (Buy)

1. Enter Amount

   Input desired fiat amount for purchase

2. Select Currencies

   Choose fiat and crypto currencies

3. Payment Method

   Select preferred payment option

4. Review & Pay

   Confirm transaction details and complete payment

Off-Ramp (Sell)

1. Enter Amount

   Input crypto amount to sell

2. Select Currencies

   Choose crypto and fiat currencies

3. Bank Details

   Enter withdrawal bank information

4. Confirm

   Review and confirm withdrawal

Usage Examples

Basic Integration

import { MercuroScreen } from '@/modules/mercuryo';

function App() {
  return (
    <NavigationContainer>
      <Stack.Navigator>
        <Stack.Screen 
          name="Mercuryo" 
          component={MercuroScreen}
          options={{ headerShown: false }}
        />
      </Stack.Navigator>
    </NavigationContainer>
  );
}

Configuration

Environment Variables

MERCURYO_API_KEY=your_mercuryo_api_key
MERCURYO_ENVIRONMENT=sandbox # or production
MERCURYO_WIDGET_ID=your_widget_id

Never commit your actual API keys to version control. Use environment variables or secure key management.

Key Features

Dual Mode

On-ramp and off-ramp functionality for complete fiat-crypto conversion

Multi-Payment

Support for cards, Apple Pay, and bank transfers with platform-specific optimizations

Real-time Rates

Live exchange calculations and transparent fee structure

Security

3D Secure authentication and KYC/AML compliance built-in

Best Practices

Implementation Tips:

• Test thoroughly in sandbox environment
• Handle platform-specific payment methods appropriately
• Implement proper error handling for network issues
• Display clear fee breakdowns
• Cache exchange rates for better UX

---

Built with ❤️ for seamless fiat-crypto conversions - Powered by Mercuryo