🧪 Complete Sandbox Testing Guide
This comprehensive guide provides all the credentials and test data you need to integrate and test with Hesabe's sandbox environment safely and effectively.
🎯Sandbox Environment Benefits
No real money transactions - test freely without financial risk
🔄 Unlimited Testing: Test all payment scenarios, edge cases, and error handling
📊 Real-time Monitoring: View all test transactions in the sandbox merchant panel
📋 Step-by-Step Testing Setup
Step 1: 🔐 Access Sandbox Merchant Panel
👤Merchant Panel Login
📝 Login Steps:
- Click the portal URL above to open the sandbox merchant panel
- Enter username:
test - Enter password:
Test@1234 - Navigate through the dashboard to monitor your test transactions
- Access API settings, reports, and transaction history
Step 2: 🔑 Configure API Credentials
🔐Sandbox API Credentials
⚠️IMPORTANT: Sandbox Only
These credentials are for sandbox testing only. Never use these in production environment.
🔧 Integration Instructions:
- Copy all credentials to your development environment configuration
- Use the Base URL for all API endpoint calls
- Keep Secret Key and IV Key secure - never expose in client-side code
- Test authentication before proceeding to payment testing
Step 3: 💳 Test Payment Cards
💳Test Card Details for Payment Testing
✅Safe Testing Cards
All card numbers below are for testing only - no real charges will occur. Use these to test different payment scenarios and card types.
🏦 KNET (Kuwait Local Cards)
💎 MasterCard
💰 American Express (AMEX)
🔷 Visa (Cybersource)
💰 AMEX (Cybersource)
Step 4: 🧪 Execute Your Tests
🧪Comprehensive Testing Checklist
✅ Required Test Scenarios:
🔐 Authentication Testing:
- Verify API credentials work correctly
- Test invalid credential scenarios
- Check token generation and validation
💳 Payment Flow Testing:
- Test each card type (KNET, MasterCard, Visa, AMEX)
- Process successful payment transactions
- Test different payment amounts and currencies
- Verify payment confirmation callbacks
❌ Error Scenario Testing:
- Test invalid card numbers and expired cards
- Simulate payment failures and declined transactions
- Test network timeout scenarios
- Verify proper error message handling
📊 Integration Verification:
- Monitor transactions in merchant panel
- Verify webhook/callback functionality
- Test refund processes (if applicable)
- Confirm reporting accuracy
Step 5: 🚀 Prepare for Production
🚀Ready for Production Migration?
Once all sandbox testing is complete and successful, you're ready to migrate to the production environment with real payment processing.
📖Next Step:Follow Production Migration Guide
🏗️Integration Docs:API Documentation