🧪 Sandbox Testing Environment

This comprehensive guide provides step-by-step instructions for testing your Hesabe payment gateway integration using our sandbox environment with detailed test credentials and scenarios.

🎯Sandbox Environment Benefits

✅ Safe Testing: Complete payment testing with zero financial risk - no real money transactions

🔄 Comprehensive Testing: Test all payment methods, error scenarios, and edge cases

📊 Real-time Monitoring: Track and monitor all test transactions through the merchant panel

📋 Step-by-Step Testing Setup

Step 1: 🚨 Review Important Testing Guidelines

🚨Important: Local Environment Setup

⚠️ Connection Issues:

If you're unable to connect to sandbox URLs from your local development environment, this is likely due to incorrect configurations.

📞 Contact our technical team for assistance:

📧 Hesabe Technical Support: itsupport@hesabe.com

Step 2: 🔧 Configure Sandbox Environment URLs

🌐Sandbox API Endpoints

🛠️Sandbox Base URL:

https://sandbox.hesabe.com

🛒Sandbox Checkout URL:

https://sandbox.hesabe.com/checkout

💳Sandbox Payment URL:

https://sandbox.hesabe.com/payment

📝 Configuration Instructions:

1. Copy the URLs above to your development environment configuration
2. Update your API base URL to point to sandbox environment
3. Ensure your application can reach these endpoints
4. Test connectivity before proceeding to authentication setup

Step 3: 🔐 Access Sandbox Merchant Panel

👤Merchant Panel Login

🔑 Username	🔐 Password	🌐 Sandbox Merchant Panel
test	Test@1234	merchant.hesbstaging.com/merchant

📝 Login Steps:

1. Click the portal URL above to open the sandbox merchant panel
2. Enter username: test
3. Enter password: Test@1234
4. Navigate through the dashboard to monitor your test transactions
5. Access transaction history, reports, and API settings

Step 4: 🔑 Configure API Credentials

🔐Sandbox API Credentials

⚠️IMPORTANT: Sandbox Only

These credentials are strictly for sandbox testing. Never use these credentials in production environment.

🏷️ Parameter	💾 Value	📋 Copy	📝 Description
Merchant Code	842217		Your unique merchant identifier
Access Code	c333729b-d060-4b74-a49d-7686a8353481		API access token for authentication
Secret Key	PkW64zMe5NVdrlPVNnjo2Jy9nOb7v1Xg		Encryption key for secure communication
IV Key	5NVdrlPVNnjo2Jy9		Initialization vector for encryption
Base URL	https://sandbox.hesabe.com		Sandbox API endpoint base URL

🔧 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
• Monitor all test transactions through the merchant panel

Step 5: 💳 Test Payment Scenarios

💳Comprehensive Test Card Library

🎯 Testing Objectives:

• Payment Success: Test approved transactions with different card types
• Payment Failures: Test declined transactions and error handling
• Edge Cases: Test expired cards, invalid CVV, and timeout scenarios
• Gateway Integration: Test multiple payment processors (KNET, MPGS, Cybersource)

📋 Test Card Details by Payment Method

KNET (Kuwait Local Payment Network)

KNET Test Cards - Kuwait Local Payment

💳 Card Number	📅 Expiry Date	🔐 CVV	📊 Expected Result
8888880000000001	09/25	1234	✅ Approved - Captured
8888880000000001	Any Other Date	1234	❌ Declined - Not Captured

💡 KNET Testing Notes:

• Use expiry date 09/25 for successful transactions
• Any other expiry date will result in declined transactions
• CVV is always 1234 for KNET test cards

---

Visa (MPGS)

Visa Test Cards - MPGS Gateway

💳 Card Number	📅 Expiry Date	🔐 CVV	📊 Expected Result
4012001037141112	12/25	207	✅ Captured (Approved)
4012001037141112	Any Other Date	207	❌ Not Captured (Decline)

💡 Visa MPGS Testing Notes:

• Use expiry date 12/25 for approved transactions
• Any other expiry date results in declined transactions
• CVV 207 is required for this test card

---

MasterCard (MPGS)

MasterCard Test Cards - MPGS Gateway

💳 Card Number	📅 Expiry Date	🔐 CVV	📊 Expected Result
5453010000095539	12/25	300	✅ Captured (Approved)
5555555555554444	09/25	123	✅ Captured (Approved)
5555555555554444	Any Other Date	123	❌ Not Captured (Decline)

💡 MasterCard MPGS Testing Notes:

• Multiple test cards available for different scenarios
• Use 12/25 or 09/25 for successful transactions
• Any other expiry date results in declined transactions

---

📊 MPGS Expiry Dates and Response Scenarios

MPGS Gateway Response Testing Matrix

📅 Expiry Date	📋 Expected Response	📝 Use Case
05/39	✅ APPROVED	Success scenario testing
05/39	❌ DECLINED	General decline testing
04/27	❌ EXPIRED_CARD	Expired card handling
08/28	❌ TIMED_OUT	Timeout scenario testing
01/37	❌ ACQUIRER_SYSTEM_ERROR	System error handling
02/37	❌ UNSPECIFIED_FAILURE	General failure testing
05/37	❌ UNKNOWN CVV	CVV validation testing

💡 MPGS Response Testing Guide:

• Test various error scenarios to ensure proper error handling
• Use different expiry dates to simulate real-world payment failures
• Implement proper timeout handling for better user experience

info

For more details below check the below documentation

MPGS Test cards information

American Express (AMEX)

American Express Test Cards - MPGS Gateway

💳 Card Number	📅 Expiry Date	🔐 CVV	📊 Expected Result
345678901234564	09/25	1234	✅ Captured (Approved)
345678901234564	Any Other Date	1234	❌ Not Captured (Decline)

💡 American Express Testing Notes:

• Use expiry date 09/25 for approved transactions
• Any other expiry date results in declined transactions
• CVV 1234 is required for this test card

---

Visa (Cybersource)

Visa Test Cards - Cybersource Gateway

💳 Card Number	📅 Expiry Date	🔐 CVV	📊 Expected Result
4000000000000002	09/25	1234	✅ Captured (Approved)
4000000000000002	Any Other Date	1234	❌ Not Captured (Decline)

💡 Visa Cybersource Testing Notes:

• Use expiry date 09/25 for approved transactions
• Any other expiry date results in declined transactions
• CVV 1234 is required for this test card

---

AMEX (Cybersource)

American Express via Cybersource

💳 Card Number	📅 Expiry Date	🔐 CVV	📊 Expected Result
340000000002708	09/25	1234	✅ Approved - Captured
340000000002708	Any Other Date	1234	❌ Declined - Not Captured

Next Steps: 🚀 Production Migration

🚀Ready for Live Payments?

Once all sandbox testing is complete and successful, follow our comprehensive production migration guide to start processing real payments.

📖Production Guide:Moving to Production

🏗️API Documentation:Complete Integration Guide

📞 Testing Support & Assistance

🔧Technical Support:itsupport@hesabe.com

👤Merchant Support:support@hesabe.com