YaniPay Mobile Documentation

// P2P Transfer
const transfer = await walletService.transfer({
  recipientId: 'usr_abc123',
  amount: '50.00',
  currency: 'EUR',
  memo: 'Remboursement restaurant',
});

// Create scheduled payment
const scheduled = await paymentService.createScheduled({
  recipientId: 'usr_xyz789',
  amount: '100.00',
  currency: 'EUR',
  frequency: 'monthly',     // 'daily' | 'weekly' | 'monthly'
  startDate: '2026-04-01',
  label: 'Loyer colocation',
});

// Wallet statistics
const stats = await walletService.getStats({
  period: '30d',  // '7d' | '30d' | '90d' | '1y'
  currency: 'EUR',
});
// => { totalSpent, totalReceived, balanceEvolution[], topCategories[] }

// SEPA transfer
const sepa = await walletService.sepaTransfer({
  iban: 'FR76 3000 6000 0112 3456 7890 189',
  beneficiaryName: 'Jean Dupont',
  amount: '250.00',
  label: 'Virement mensuel',
});

// Logique de sélection automatique de l'URL API
function getDefaultApiUrl(): string {
  if (__DEV__) {
    // expo-constants expose l'IP du dev server (ex: "192.168.1.28:8081")
    const debuggerHost =
      Constants.expoConfig?.hostUri ??
      Constants.manifest2?.extra?.expoGo?.debuggerHost;
    if (debuggerHost) {
      const host = debuggerHost.split(':')[0]; // on retire le port Expo
      return `http://${host}:3000/api`;
    }
  }
  return 'https://yanipay.com/api';
}

// Priorité à la variable d'environnement si définie
export const API_BASE_URL =
  process.env.EXPO_PUBLIC_API_URL || getDefaultApiUrl();

# Pour pointer vers le serveur VPS de développement
EXPO_PUBLIC_API_URL=http://51.77.222.1:3000/api

// Core Framework
React Native: 0.81.5
Expo SDK: 54
TypeScript: 5.9.3
Expo Router: v6 (file-based routing)

// State Management
Zustand: Lightweight store (auth, preferences)
TanStack React Query: v5.17 (server state + cache)

// UI & Animations
React Native Reanimated: v4.1.1
Expo Linear Gradient
Expo Blur
Custom theme system (dark/light)

// Payments & Identity
Stripe React Native: v0.50.3 (cards, NFC, top-up)
Onfido SDK: v10.6.0 (KYC documents + selfie)

// DeFi
Custom staking service (multi-pool)
DEX service (AMM swap)
Yield farming integration

// Security
Expo SecureStore (encrypted storage)
Expo Local Authentication (Face ID / Touch ID)
JWT + refresh token rotation
Device fingerprinting

// Networking
Axios with custom interceptors
Automatic retry (exponential backoff)
Offline queue with conflict resolution
Push notifications (FCM + APNs)

// i18n
16+ languages supported
RTL layout support

mobile/
├── app/                          # Expo Router screens (67 screens)
│   ├── _layout.tsx              # Root layout with providers
│   ├── index.tsx                # Splash screen
│   ├── (auth)/                  # Auth: login, register, welcome, forgot-password
│   ├── (tabs)/                  # Main: home, cards, scan, wallet, profile
│   ├── identity/                # KYC: documents, selfie, address, proof
│   ├── payment/                 # Payments: send, receive, topup, qr-pay, scheduled
│   ├── defi/                    # DeFi: staking, swap, pools, rewards, governance
│   ├── loyalty/                 # Loyalty: cashback, challenges, tiers, rewards, referrals
│   ├── settings/                # Settings: profile, security, notifications, appearance, language
│   ├── support/                 # Support: FAQ, contact, help center, tickets
│   └── legal/                   # Legal: terms, privacy, licenses
├── src/
│   ├── components/              # Reusable UI components
│   │   ├── ui/                 # Base UI elements
│   │   ├── cards/              # Card components
│   │   ├── loyalty/            # Loyalty UI
│   │   └── defi/               # DeFi UI
│   ├── services/                # API service layer (14 services)
│   │   ├── api.ts              # Base API client + interceptors
│   │   ├── userService.ts      # User profile & preferences
│   │   ├── walletService.ts    # Wallet & transactions
│   │   ├── cardService.ts      # Card management
│   │   ├── paymentService.ts   # Payment processing
│   │   ├── transactionService.ts # Transaction history
│   │   ├── kycService.ts       # Identity verification
│   │   ├── loyaltyService.ts   # Loyalty programs & rewards
│   │   ├── stakingService.ts   # DeFi staking
│   │   ├── dexService.ts       # Token swap (DEX)
│   │   ├── identityService.ts  # Document management
│   │   ├── notificationService.ts # Push & in-app
│   │   ├── offlineQueue.ts     # Offline sync queue
│   │   └── supportService.ts   # Help & tickets
│   ├── store/                   # Zustand stores
│   │   ├── authStore.ts        # Auth state + biometric
│   │   └── preferencesStore.ts # User preferences
│   ├── hooks/                   # Custom React hooks
│   ├── config/                  # Constants & configuration
│   ├── types/                   # TypeScript interfaces
│   ├── i18n/                    # Internationalization (16+ languages)
│   └── utils/                   # Helper functions
├── assets/                      # Images, icons, fonts
└── app.json                     # Expo configuration