Quick Start Guide
Get up and running with YaniPay DeFi in less than 5 minutes. This guide covers the complete setup from installation to your first API call.
Why YaniPay?
YaniPay est une super-app fintech de nouvelle génération qui révolutionne les paiements digitaux en combinant la puissance du Web3 avec une expérience utilisateur simplifiée. Construite sur YaniChain, notre blockchain hybride offrant 50 000+ TPS, YaniPay permet aux utilisateurs de gérer leur argent, investir, et payer partout dans le monde.
En tant que développeur, YaniPay vous offre une plateforme robuste avec des APIs modernes, une architecture microservices, et des outils d'intégration puissants. Que vous souhaitiez intégrer des paiements, du staking DeFi, ou construire sur notre écosystème, ce guide vous accompagne pas à pas.
Écosystème Complet
YaniPay combine :
- Banking - Comptes multi-devises, cartes virtuelles/physiques, IBAN
- DeFi - Staking YANICoin, Swap, Lending avec des APY compétitifs
- Loyalty- Cashback automatique jusqu'à 3%, challenges et récompenses
- Identity - KYC automatisé, vérification biométrique
Technologies
YaniPay repose sur deux technologies sous-jacentes innovantes qui transforment l'industrie financière :
Y.A.N.I.
Intelligence Artificielle
Agent IA basé sur Claude Code qui remplace le conseiller bancaire traditionnel. Plus rapide, plus intelligent, disponible 24/7.
YaniChain
Blockchain
Infrastructure blockchain décentralisée avec 50 000+ TPS. YANI Coin pour la fidélisation et les tokens sectoriels.
Synergie IA + Blockchain
User Cases
Voici comment différents profils d'utilisateurs bénéficient de YaniPay :
Marie, Commerçante
Propriétaire d'un café à Paris, Marie utilise YaniPay pour :
- • Accepter les paiements QR/NFC instantanés
- • Gérer sa trésorerie multi-devises
- • Fidéliser ses clients avec du cashback
- • Consulter ses analytics de ventes
Thomas, Étudiant
Étudiant en informatique, Thomas utilise YaniPay pour :
- • Gérer son budget mensuel
- • Investir ses économies en staking
- • Payer ses achats avec 2% cashback
- • Partager les frais avec ses colocs
Sophie, Développeuse
Lead Dev dans une startup, Sophie utilise l'API pour :
- • Intégrer les paiements dans son app
- • Automatiser les virements fournisseurs
- • Construire des dashboards financiers
- • Tester en sandbox avant prod
Architecture Overview
YaniPay utilise une architecture moderne multi-plateforme. Voici comment les différentes couches interagissent :
Synchronisation Temps Réel
Prerequisites
Before you begin, ensure you have the following installed:
Node.js 20+
Requis pour faire tourner Next.js 16. Télécharger →
pnpm 9+
Gestionnaire de paquets obligatoire (npm/yarn non supportés). Installer →
PostgreSQL 14+
Base de données principale via Prisma ORM. Télécharger →
Git
Pour cloner le dépôt depuis GitHub. Télécharger →
Installation
Clone the repository and install dependencies:
# Clone the repository
git clone https://github.com/YaniPay/yanipay-animation.git
# Navigate to project directory
cd yanipay-animation
# Install dependencies
pnpm installPro Tip: Turbopack
pnpm dev:webpack.Sécurité : pnpm overrides CVE
Le fichier package.json inclut des pnpm.overridespour corriger des CVE dans les dépendances transitives (ajouté lors du commit 2fed86e0). Ces overrides sont appliqués automatiquement lors de pnpm install— aucune action supplémentaire n'est requise. Ne pas utiliser npm install ou yarnqui ignoreraient ces correctifs de sécurité.
Database Setup
Configure your database connection and initialize Prisma:
1. Create Environment File
# Copy example environment file
cp .env.local.example .env.local2. Configure Database URL
Edit .env.local and add your PostgreSQL connection string:
# Database
DATABASE_URL="postgresql://username:password@localhost:5432/yanipay"
# NextAuth
NEXTAUTH_SECRET="your-secret-key-here"
NEXTAUTH_URL="http://localhost:3000"
# Optional: AI Features
ELEVENLABS_API_KEY="your-elevenlabs-key"
GEMINI_API_KEY="your-gemini-key"Sécurité
.env.local! Il contient des secrets sensibles. Assurez-vous qu'il est bien dans votre .gitignore.3. Initialize Database
# Generate Prisma client
npx prisma generate
# Push schema to database
npx prisma db push
# (Optional) Open Prisma Studio to view your database
npx prisma studioRunning Development Server
Start the development server and view your application:
pnpm dev🎉 Success!
Your application is now running at http://localhost:3000
Your First API Call
Let's make your first API call to fetch available crypto assets:
1 // Fetch all supported crypto assets 2 const response = await fetch('http://localhost:3000/api/defi/assets'); 3 const data = await response.json(); 4 5 console.log('Available assets:', data.assets); 6 // Output: Array of crypto assets (BTC, ETH, YANI, etc.)
Try it with curl:
curl http://localhost:3000/api/defi/assets | jqExpected response:
{
"assets": [
{
"id": "uuid-here",
"symbol": "YANI",
"name": "YANICoin",
"network": "YaniChain",
"decimals": 18,
"isActive": true,
"supportsStaking": true,
"supportsSwap": true
},
// ... more assets
],
"count": 10
}Mode Sandbox
.env.local et passez en mode production.Next Steps
Now that you have YaniPay running, explore these topics:
Wallet Management
Learn how to create and manage multi-asset crypto wallets
Staking YANI
Stake tokens and earn rewards with flexible lock periods
Integration Guides
Step-by-step guides for integrating YaniPay features
Mobile Development
Build native mobile apps with React Native and Expo
Y.A.N.I. (IA)
Découvrez l'intelligence artificielle qui pilote YaniPay
YaniChain
Explorez notre blockchain et l'écosystème YANI Coin
References & Resources
YaniPay s'appuie sur des technologies éprouvées et des best practices reconnues. Voici les ressources officielles pour approfondir :
Framework officiel - App Router, Server Components, API Routes
Type-safe database client - Schema, Migrations, Queries
Best practices de sécurité pour APIs - Top 10 vulnérabilités
React Native framework - SDK 54, Router v6, Build services
Besoin d'aide ?
Si vous rencontrez des problèmes lors de la configuration, consultez notre guide de dépannage ou ouvrez une issue sur GitHub.
Dernière mise à jour : 9 avril 2026