Integrating Mobile Payments into Your Forms
Collecting payments alongside form submissions opens new possibilities for event registration, application fees, donations, and more. This guide walks you through setting up mobile money payments in Jawaab.
Why Accept Payments in Forms?
Traditional payment collection often means:
- Separate payment portals
- Manual reconciliation
- Lost or disputed payments
- Complex follow-up processes
With integrated payments, you get:
- Single submission with payment
- Automatic matching of payments to responses
- Real-time confirmation
- Simplified accounting
Supported Payment Methods
Jawaab currently supports:
- EVC Plus (Hormuud Telecom)
- Zaad (Telesom)
- Bank Transfer (for larger transactions)
More options coming soon!
Step-by-Step Setup
Step 1: Enable JawaabPay
- Navigate to Settings → Payments
- Click Enable JawaabPay
- Agree to the terms of service
Step 2: Configure Your Provider
For EVC Plus:
- Select EVC Plus as your provider
- Enter your Merchant ID (from Hormuud)
- Enter your API credentials
- Choose test mode for initial setup
For Zaad:
- Select Zaad as your provider
- Enter your business short code
- Enter your API key
- Enable test mode
Step 3: Add Payment to Your Form
- Open your form in the builder
- Drag the Payment field from the special fields section
- Configure payment settings:
- Fixed amount: Same for everyone
- Variable amount: User enters amount
- Calculated: Based on other form fields
Step 4: Set Up Confirmation
- In form settings, go to After Submission
- Customize the payment confirmation message
- Optionally send a receipt by email
Step 5: Test the Integration
- Ensure test mode is enabled
- Submit a test response
- Complete a test payment
- Verify the response shows "Paid"
- Check that confirmation email arrives
Step 6: Go Live
- Go to Settings → Payments
- Toggle off test mode
- Your form is now accepting real payments!
Use Cases
Event Registration with Fees
Collect registration details and payment in one form. No separate checkout required.
Application Fees
Universities and training programs can collect application fees alongside applications.
Donations
NGOs can embed donation amounts directly in impact stories and campaign pages.
Service Payments
Businesses can bill customers through custom forms with itemized services.
Payment Reports
Access your payment data in Payments in the sidebar:
- View all transactions
- Filter by form, date, or status
- Export for accounting
- See refund history
Handling Failed Payments
If a payment fails:
- The respondent sees an error message
- They can retry without losing form data
- You're notified of the failure
- The response is saved as "Pending Payment"
Best Practices
- Clear pricing: Show the amount clearly before payment
- Mobile-friendly: Test on phones, not just desktop
- Receipt emails: Always send confirmation
- Support info: Include contact for payment issues
Security
Payment data is:
- Encrypted in transit and at rest
- Never stored on our servers (only payment provider)
- PCI DSS compliant
- Protected by fraud monitoring
Ready to start accepting payments? Get started free or contact us for help setting up.
Jawaab Team
Content Team
The Jawaab Team shares insights on form building, data collection, and digital transformation in East Africa.