If your Uganda eVisa application at visas.immigration.go.ug is not working, errors usually stem from payment card declines, files exceeding the 250 KB limit, or browser cache conflicts. Switch to Google Chrome, compress files under 250 KB, and pay with a 3D-Secure enabled Visa or Mastercard in a single session.
This 2026 troubleshooting guide provides direct fixes for payment gateway errors, upload failures, form validation blocks, and firewall conflicts on the Uganda Electronic Visa/Permit Application System.
Quick Troubleshooting Diagnostic Checklist
Match your Uganda eVisa application error directly to its immediate fix using this quick diagnostic reference before troubleshooting further.
| Error / Symptom | Root Cause | Actionable Solution |
|---|---|---|
| “Your transaction was unsuccessful, please check your details” or “Pending payment” | Unsupported card issuer or US bank fraud protection block | Pay using Visa or Mastercard only. Call your bank (Chase, BoA, Wells Fargo) to authorize Ugandan charges for $50 USD plus the 3% surcharge. |
| Document upload fails or drops attached file | File exceeds 250 KB limit or uses unsupported format | Compress files to under 250 KB using PDF, JPEG, PNG, or BMP formats. |
| “Cannot apply twice with the same passport…” | Active application record already exists in the system | Check status at visas.immigration.go.ug/#/check instead of submitting duplicate details. |
| Form freezes, blank screen, or gateway timeout | Browser script conflict (Safari) or session expiry | Switch to Google Chrome, clear cache, and complete all 4 steps in one sitting. |
| Portal fails to load or access denied | Active VPN, strict firewall, or ISP blocking | Disable VPNs/ad-blockers, set DNS to Google (8.8.8.8), or use a mobile hotspot. |
Fixing Uganda eVisa Payment Failures and US Card Issues
Payment fails when your bank blocks international charges, you use an unsupported card, or the session expires. The portal charges $50 USD plus a 3% surcharge for ordinary tourist visas (or $100 USD for the East Africa Tourist Visa). Payment processing requires Visa and Mastercard only; American Express, Discover, Diners Club, and PayPal are automatically declined. For a full breakdown of accepted payment methods and surcharge details, see our Uganda eVisa payment methods and declined payment solutions guide.
- Authorize US bank international charges: Contact card issuers like Chase, Bank of America, or Wells Fargo prior to payment to clear automated fraud flags for Uganda.
- Ensure 3D-Secure is active: Use a credit or debit card supporting 3D-Secure OTP verification to prevent the “Your transaction was unsuccessful” error.
- Reset stuck checkout sessions: If stuck on “Pending payment,” wait for the session to clear, clear browser cookies, and retry. Payments made directly to embassy bank accounts are non-refundable and cannot be applied online. Review the full Uganda eVisa refund policy and double-charge resolution process if you believe you were charged incorrectly.
Resolving Document Upload and Technical File Errors
Upload errors occur when files exceed 250 KB or use non-standard formats. The Uganda eVisa portal rejects non-compliant attachments without clear warning pop-ups, leaving applicants stuck on step three. Consult our complete document requirements and upload specifications guide for detailed file preparation instructions.
Document Upload Specifications
- File Size Limit: Maximum 250 KB per file for all attachments.
- Allowed Formats: PDF, JPEG, PNG, and BMP exclusively.
- Passport Bio-Data Page: Clear scan displaying all personal data, valid for at least 6 months from arrival.
- Passport Photo Standards: Recent passport-style photograph (35x45mm) on a light-colored background. See the Uganda eVisa passport photo requirements for full compliance details.
- Vaccination Update: Yellow fever vaccination certificates are no longer required for upload during the online application as of August 2026.
Form Field Validation Rules and Submission Errors
The Uganda Electronic Visa/Permit Application System enforces strict syntax validation across its 4-step submission form. Violating input rules prevents form submission. For detailed guidance on each field, refer to the Uganda eVisa application form field-by-field instructions:
- Name and Text Fields: Use English letters only. Do not enter special characters, accent marks, or punctuation.
- Passport Number: Enter digits and letters with no spaces.
- Phone Numbers: Include only numbers and the “+” symbol (e.g., +12025550199). Omit brackets, hyphens, or spaces.
- Date Format: Enter dates strictly in DD/MM/YYYY format.
Browser Compatibility, Security Settings, and VPN Conflicts
If the Uganda eVisa application is not working due to a blank screen or frozen form, the issue is likely a browser conflict. The portal requires Google Chrome or Mozilla Firefox with JavaScript enabled. Apple Safari frequently causes validation and payment frame errors. Our application tips guide covers additional best practices for completing the form without errors.
Clearing Cache and Fixing Security Blocks
- Complete in One Sitting: The portal does not allow saving drafts. Prepare all documents under 250 KB beforehand.
- Clear Cache: Press Ctrl+Shift+Delete (or Cmd+Shift+Delete) to clear cookies and cached images.
- Disable VPNs and Firewalls: Disable active VPNs, ad blockers, and third-party security software that block cross-origin scripts.
- ISP / Network Workarounds: If the portal will not load, switch DNS settings to Google DNS (8.8.8.8) or connect via a mobile hotspot.
System Downtime and Support Channels
During system maintenance or server outages (such as the 10-day upgrade in October 2024), the portal may display 500-level errors. Verify portal status by checking the Uganda Immigration Facebook page or testing the application tracking portal at visas.immigration.go.ug/#/check. For a full overview of typical processing windows, review our Uganda eVisa processing time and submission guide.
Standard processing takes 2 to 3 working days. Applicants should apply at least 5 working days prior to travel. Approved eVisas are valid for 3 months from the issue date and emailed as a printable approval letter with a barcode.
If technical issues persist, contact the Department of Citizenship and Immigration Control:
- Phone: +256 417 102 600 (7:00 AM to 7:00 PM East Africa Time, UTC+3)
- Toll-Free (Uganda only): 0800 199 004 / 0800 199 003
- Email: [email protected]
Frequently Asked Questions (FAQ)
What payment cards are accepted for the Uganda eVisa fee?
Only Visa and Mastercard are accepted. American Express, Discover, Diners Club, and PayPal are declined. A 3% surcharge applies to the $50 USD tourist visa fee (or $100 USD for the East Africa Tourist Visa).
Why does my document upload keep failing on the Uganda eVisa portal?
Uploads fail when files exceed 250 KB or use formats other than PDF, JPEG, PNG, or BMP. Compress your files and remove special characters from file names before attaching them.
Can I save my Uganda eVisa form and complete it later?
No. The Uganda eVisa portal does not save draft applications. You must complete all four steps and submit payment in one sitting.
What should I do if my payment status is stuck on ‘pending’?
Check your bank statement to see if funds were deducted. If charged, wait up to 24 hours and verify your reference number at visas.immigration.go.ug/#/check before making another payment.
Which browser works best for the Uganda eVisa portal?
Google Chrome works best. Apple Safari frequently encounters script execution and display errors on this portal.
Why am I getting a duplicate application error?
This error occurs when an active submission already exists for your passport details. Track your existing status at visas.immigration.go.ug/#/check or allow open sessions to expire.
How do I check if the Uganda eVisa portal is down?
Test access on a mobile network, check for updates on the Uganda Immigration Facebook page, or track existing applications at visas.immigration.go.ug/#/check.
How do I contact technical support for submission issues?
Call +256 417 102 600 (7:00 AM to 7:00 PM EAT) or email [email protected] with screenshots of the error.
