​
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

MethodPlatformsFeeProcessing Time
Credit/Debit CardiOS, Android2.5%Instant
Apple PayiOS only1.8%Instant
Bank TransferiOS, Android1.0%1-3 business days

​
Supported Assets

​
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

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