Skip to main content

Base URLs

EnvironmentURL
Productionhttps://pass.mediageneral.digital
Staginghttps://pass.mgdm.dev

Authentication

Partner API Key

X-API-Key header for partner event publishing

User Token

Authorization: Bearer <token> for user-facing endpoints

Admin Token

Bearer token with mgpass:admin scope for management endpoints

Endpoint Groups

GroupBase PathAuthPurpose
Partner Events/api/partner/API KeyPublish events, award points
User Rewards/api/account/rewards/User TokenBalance, history, redemptions
Cashback/api/account/cashback/User TokenMobile money redemption
Admin Rules/api/rewards/rules/Admin TokenManage points rules
Admin Partners/api/rewards/partners/Admin TokenManage partner configs
Admin Redemptions/api/rewards/redemptions/Admin TokenView/manage redemptions
Admin Ledger/api/rewards/ledger/Admin TokenSearch/export transaction log

Response Format

All successful responses return JSON. Paginated endpoints include:
{
  "results": [...],
  "total": 150,
  "page": 1
}

Rate Limits

EndpointLimit
Partner events30 req/min per IP
General API100 req/min per IP
See Error Handling for retry strategies.