Back to Blog
    Tutorial

    Integrating Mobile Payments into Your Forms

    Step-by-step guide to accepting EVC Plus and Zaad payments directly within your Jawaab.

    Jawaab TeamDec 28, 20254 min read

    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

    1. Navigate to Settings → Payments
    2. Click Enable JawaabPay
    3. Agree to the terms of service

    Step 2: Configure Your Provider

    For EVC Plus:

    1. Select EVC Plus as your provider
    2. Enter your Merchant ID (from Hormuud)
    3. Enter your API credentials
    4. Choose test mode for initial setup

    For Zaad:

    1. Select Zaad as your provider
    2. Enter your business short code
    3. Enter your API key
    4. Enable test mode

    Step 3: Add Payment to Your Form

    1. Open your form in the builder
    2. Drag the Payment field from the special fields section
    3. Configure payment settings:
      • Fixed amount: Same for everyone
      • Variable amount: User enters amount
      • Calculated: Based on other form fields

    Step 4: Set Up Confirmation

    1. In form settings, go to After Submission
    2. Customize the payment confirmation message
    3. Optionally send a receipt by email

    Step 5: Test the Integration

    1. Ensure test mode is enabled
    2. Submit a test response
    3. Complete a test payment
    4. Verify the response shows "Paid"
    5. Check that confirmation email arrives

    Step 6: Go Live

    1. Go to Settings → Payments
    2. Toggle off test mode
    3. 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

    1. Clear pricing: Show the amount clearly before payment
    2. Mobile-friendly: Test on phones, not just desktop
    3. Receipt emails: Always send confirmation
    4. 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.

    Ready to build better forms?

    Start free and upgrade when you need more.