referral site design

[samkiell]

designing referral.axile.ng

Temi, we would need this backend api emdpoints, its just a rough scalfold, please work with it and enhance it, thanks

🔐 Authentication

POST /auth/register
POST /auth/login
GET /auth/me

🎟 Events

POST /events
GET /events
GET /events/{eventId}
GET /events?referralEnabled=true

🔗 Referral

GET /r/{refCode}/events/{eventId}

🎫 Ticket Purchase Webhook (Internal)

POST /webhooks/tickets/purchased

✅ Ticket Check-in Webhook (Internal)

POST /webhooks/tickets/checked-in

💰 Wallet

GET /wallet
GET /wallet/transactions

💸 Withdrawals

POST /withdrawals
GET /withdrawals

Request/Response Models:

python

Create Event Request

{
"title": "Summer Music Festival",
"price": 5000,
"referralEnabled": true,
"rewardType": "percentage", // "percentage" | "fixed"
"rewardValue": 30
}

Purchase Webhook Request (Internal)

{
"buyerId": "usr_123xyz",
"eventId": "evt_456abc",
"ticketId": "tkt_789def",
"referralCode": "SUMMER30" // Optional
}

Check-in Webhook Request (Internal)

{
"ticketId": "tkt_789def"
}

Withdrawal Request

{
"amount": 1000,
"paymentMethod": "paypal", // or "bank_transfer", "gcash", etc.
"accountDetails": {
"email": "user@example.com"
}
}
Database Schema:

sql
referrals (
id UUID PRIMARY KEY,
referrer_id UUID NOT NULL,
buyer_id UUID,
event_id UUID NOT NULL,
ticket_id UUID,
points_earned INT DEFAULT 0,
status referral_status DEFAULT 'pending', -- pending | credited | expired
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
)