Appearance
Payment Account Setup
EaseLab supports manual payment workflows common in Pakistan: JazzCash, Easypaisa, and bank transfer. Platform admins configure the payment account details that tenants see during checkout.
Manual payments model
When Billing:ManualPaymentsOnly is true (default for many deployments):
| Step | Actor | Action |
|---|---|---|
| 1 | Tenant | Selects plan on checkout page |
| 2 | Tenant | Sends payment to configured account |
| 3 | Tenant | Submits payment proof via checkout form |
| 4 | Platform admin | Verifies and approves payment |
| 5 | System | Activates subscription, unlocks tenant |
Online payment gateway integration may be added per deployment; manual flow is the baseline.
Payment account fields
Configure at Admin Portal → Settings → Payment Account or via API:
| Field | Description |
|---|---|
| JazzCash number | Mobile account for JazzCash transfers |
| JazzCash account title | Account holder name |
| Easypaisa number | Mobile account for Easypaisa |
| Easypaisa account title | Account holder name |
| Bank name | e.g. HBL, Meezan, UBL |
| Bank account number | IBAN or account number |
| Bank account title | Registered account name |
| Instructions | Free-text payment instructions shown to tenants |
API:
| Method | Endpoint |
|---|---|
| GET | /admin/settings/payment-account |
| PUT | /admin/settings/payment-account |
Requires platform.tenants.billing permission.
Tenant-facing display
Tenants retrieve payment details during checkout:
| Endpoint | Audience |
|---|---|
GET /billing/payment-account | Authenticated tenant (checkout) |
GET /billing/manual-payment-settings | Payment form configuration |
The checkout page shows all configured methods with copy-friendly account numbers.
Payment approval workflow
| Status | Meaning |
|---|---|
Pending | Tenant submitted proof; awaiting review |
Approved | Payment confirmed; subscription activated |
Rejected | Invalid proof; tenant notified |
Platform admins review pending payments in the admin portal billing section.
Development testing
In development, POST /billing/dev-complete/{paymentId} simulates payment approval without manual review. This endpoint is disabled in production.
SMS test
Verify SMS gateway configuration (payment notifications) via POST /admin/settings/test-sms with a test phone number.
Security notes
- Payment account details are not secrets but should be accurate to prevent fraud.
- Only platform admins with billing permission can modify settings.
- Tenants cannot change platform payment accounts.