Support & FAQ
Get help with the YaniPay platform and find answers to common questions about payments, loyalty, identity, and more.
Frequently Asked Questions
Account & Authentication
What is YaniPay?
YaniPay is a fintech super-app combining digital payments, loyalty programs, identity verification (KYC), smart cards, and DeFi services. It features 3 dashboard tiers (Particulier, Professionnel, Admin) with 171+ API routes.
How do I create an account?
You can register using email/password or OAuth providers (Google, GitHub). Visit /auth/signinand click "Create Account". After registration, you'll be directed to the Particulier dashboard.
What are the different user roles?
YaniPay has three roles: Particulier (consumer access to payments, loyalty, DeFi), Professionnel (merchant tools, loyalty programs, analytics), and Admin (full platform control, KYC review, monitoring). Roles are managed via RBAC middleware.
How does authentication work?
YaniPay uses NextAuth.js v5 with a unified JWT system. OAuth providers handle social login, while getCurrentUser() validates sessions for API routes. Sessions include role-based claims for RBAC.
Payments & Cards
How do I make a payment?
Payments are processed through Stripe. Use the POST /api/paymentsendpoint to create a checkout session, which redirects the user to Stripe's hosted checkout page. Successful payments trigger a webhook notification.
Can I get a virtual or physical card?
Yes. YaniPay supports both virtual and physical card issuance. Cards are managed through the /api/cards API endpoints. You can freeze, unfreeze, and set spending limits on your cards from the dashboard.
What payment methods are supported?
Through Stripe, YaniPay supports credit/debit cards (Visa, Mastercard, Amex), bank transfers (SEPA), Apple Pay, Google Pay, and other local payment methods depending on your region.
Loyalty & Rewards
How do loyalty programs work?
Merchants (Professionnel accounts) create loyalty programs with customizable rules. Consumers earn points or cashback on purchases. Points can be redeemed in the rewards store or converted. Use /api/loyalty/programs to manage programs.
How does the referral system work?
Each user gets a unique referral code. When a referred user completes registration and their first transaction, both the referrer and referee earn bonus points. Track referrals via the dashboard or /api/loyalty/referrals.
Can I redeem rewards?
Yes. Visit the Rewards Store in your dashboard to browse available rewards. Points can be redeemed for gift cards, discounts, cashback, or partner offers. Redemption history is tracked in your profile.
Identity Verification (KYC)
Why do I need to verify my identity?
Identity verification is required for regulatory compliance (AML/KYC). It unlocks higher transaction limits, card issuance, and full platform access. Verification is powered by Onfido.
What documents are accepted?
Onfido accepts national ID cards, passports, and driving licenses. You'll also need to complete a facial verification (selfie or video). Documents are processed automatically and reviewed by admin if needed.
How long does verification take?
Automated verification typically completes within minutes. If manual review is required (flagged documents), an admin will review within 24-48 hours. Check status via the dashboard or GET /api/kyc/status.
Security & Privacy
How is my data protected?
YaniPay implements multiple security layers: CSP headers, rate limiting (100 req/min/IP), HMAC-SHA256 webhook verification, JWT token encryption, and environment variable validation via Zod. Sensitive data is never logged.
Is two-factor authentication supported?
OAuth providers (Google, GitHub) offer their own 2FA. For credential-based accounts, additional security is provided through session management and device tracking. Full TOTP 2FA is on the roadmap.
DeFi Services
What DeFi features are available?
YaniPay offers staking (multiple pools with flexible lock periods), DEX (AMM-based token swaps), yield farming (LP token staking), and DAO governance (community proposals and voting). These services run on YaniChain.
What is YANI token?
YANI is the native token of YaniPay with a total supply of 7 billion. It's used for staking rewards, governance voting, trading fees, and DeFi incentives on YaniChain.