Developer documentation
The operating system
for communities.
HellOOpass gives cooperatives, unions, and member groups the digital infrastructure to trade, pay, and manage finances together on a secure, borderless network — with a developer-friendly payments API for your application.
curl -X POST https://sandbox-api.helloopass.example/v1/payments \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 1000,
"currency": "ETB",
"reference": "order_1024",
"callback_url": "https://your-app.com/checkout/return"
}'Endpoint paths and fields shown here are illustrative placeholders until the final HellOOpass API contract is published. See the Quick Start Guide.
Key building blocks
HellOOpass gives communities the full digital toolkit to organize, transact, and grow — all under one roof.
Digital Wallets
Every member gets a wallet for payments and trading — mobile-first, even in low connectivity.
KYC Verification
Identity checks that keep the network trusted and compliant.
Share Management (RTSM)
Real-time share, equity, and member-balance tracking for cooperatives and unions.
Provider Store
A trusted marketplace where verified providers publish digital solutions.
Master Licenses
Operate HellOOpass in your territory through a franchise model.
Hpass Wealth OS
Wealth-management layer for the HellOOpass ecosystem.
From registration to your first payment
Follow a structured integration journey designed to help your organization get ready to accept payments through HellOOpass.
Register Your Organization
Create your HellOOpass account and register a project for your community, business, or service.
02Complete Your Profile
Provide the required business information and upload the documents needed for verification.
03Access Your Dashboard
Open the merchant dashboard to collect your API credentials and manage projects.
04Configure Your Payments
Set up your settlement account and configure your webhook endpoint to receive payment notifications.
05Start Accepting Payments
Integrate the API, onboard your users, initiate payments, and process transaction results.
Everything developers need to integrate
Core capabilities covered by the HellOOpass Payment API documentation.
API authentication and credentials
Authenticate server-to-server requests with project API credentials issued through the merchant dashboard.
Payment initialization
Create payment requests from your backend with amount, currency, and customer reference details.
Transaction status and verification
Retrieve payment details and verify transaction outcomes from your server — never from browser redirects alone.
Webhook notifications
Receive signed webhook events when payment states change, with retries and signature verification guidance.
Settlement configuration
Register and manage the settlement account that receives cleared funds for your business.
Error handling and troubleshooting
Structured HTTP and application error codes with recommended corrective actions for common failure modes.
Sandbox testing
Validate your integration against the sandbox environment before switching to production credentials.
Security best practices
Guidance on secret handling, webhook signatures, idempotency, and safe order-state updates.
Start building with HellOOpass
Get your organization registered, configure your project, and follow the integration guide to connect your application to HellOOpass.