CBS Bonuses API Documentation

Cross Border Summit Bonus Platform - GFAVIP Ecosystem Citizen

✅
GFAVIP Ecosystem Citizen

Fully integrated with wallet.gfavip.com Simple SSO

Overview

The CBS Bonuses platform allows Cross Border Summit attendees to view, claim, and manage event bonuses. Built as a GFAVIP mini-app with seamless SSO integration.

Key Features

  • GFAVIP SSO Authentication - One login for all GFAVIP apps
  • Event-Based Access - Automatic eligibility via tickets.gfavip.com integration
  • Bonus Claims System - Track and manage bonus redemptions
  • Multi-Tenant Issuers - Bronze/Silver/Gold issuer tiers (coming soon)

Authentication

CBS Bonuses uses wallet.gfavip.com Simple SSO - no API keys needed!

🔑 Token Format: gfavip-session-{userId}

Making Authenticated Requests

// Include SSO token from wallet.gfavip.com in Authorization header
fetch('https://bonus.crossbordersummit.com/api/endpoint', {
  headers: {
    'Authorization': 'Bearer gfavip-session-{userId}',
    'Content-Type': 'application/json'
  }
});

No extra headers needed! We extract the user ID directly from the token.

API Endpoints

GET /api/user-tickets

Get Current User's GFAVIP Tickets

Fetches authenticated user's tickets from tickets.gfavip.com

Headers:

Authorization: Bearer gfavip-session-{userId}

Response:

{
  "tickets": [
    {
      "id": 13,
      "eventId": 7,
      "eventName": "Test Event for CBS Bonus",
      "status": "PAID"
    }
  ]
}
📋 Coming Soon:
  • POST /api/issuer/apply - Apply to become a bonus issuer
  • POST /api/issuer/bonuses - Create bonuses (issuers only)
  • GET /api/issuer/claims - View claim redemptions
  • POST /api/claims/:id/messages - Message thread with users

Integration with Other GFAVIP Apps

CBS Bonuses integrates seamlessly with the GFAVIP ecosystem:

Connected Apps

🎫 tickets.gfavip.com

Automatic event eligibility via ticket ownership

👤 profile.gfavip.com

Company info auto-fill for issuer applications

🔐 wallet.gfavip.com

Central SSO authentication hub

Technical Specifications

Stack

  • Backend: Python Flask + PostgreSQL
  • Frontend: Jinja2 templates with vanilla JS
  • Database: PostgreSQL with SQLAlchemy ORM
  • Authentication: Flask-Login + GFAVIP SSO
  • Deployment: Replit Autoscale

Database Schema

  • users - User accounts with role (USER, ISSUER_*, ADMIN)
  • events - CBS events with bonuses
  • bonuses - Event perks/bonuses with issuer ownership
  • user_events - Event access eligibility
  • claims - Bonus claim records with status tracking
  • issuer_applications - Issuer tier applications (Phase 2)
  • claim_messages - Claim conversation threads (Phase 2)

Support & Contact

Need Help?

For integration support or questions about the CBS Bonuses platform:

Part of the GFAVIP Ecosystem 🌐

Built with Simple SSO