🔁 Flows
End-to-end journeys that connect the website and the mobile app.
1 · Website → App handoff
- Visitor taps Login / Get Started / Buy / Sell on the website.
- detectDevice() runs client-side.
- iOS/Android → redirect straight to the store; desktop → QR/download modal.
- User installs the app and authenticates there — the website never sees a session.
2 · Buy crypto (mobile)
- Select asset → enter NGN amount.
- POST /trade/quote locks a rate for 30s.
- Review screen shows rate, fee, total.
- Confirm → POST /trade/buy with a clientTransactionId.
- Status screen polls until completed / failed.
3 · Sell a gift card
- Pick brand → country → face value.
- Capture front/back photos (camera or gallery).
- Optional notes → review → POST /giftcards/submit (multipart).
- Status tracked as pending_review → approved/rejected → paid.