Skip to main content

🧪 Sandbox Environment

Hesabe provides comprehensive testing and production environments to ensure seamless payment integration. This guide will walk you through setting up and using both environments step by step.

🎯Quick Environment Overview

🧪 Sandbox Environment: Safe testing environment for development - No real money involved

🚀 Production Environment: Live environment for real transactions - Real payments processed

📋 Step-by-Step Setup Guide​

Step 1: Choose Your Environment​

🧪 For Development & Testing → Use Sandbox​

✅ Use Sandbox When:
  • Building and testing your integration
  • Debugging payment flows
  • Training your team
  • Demo purposes

🚀 For Live Transactions → Use Production​

✅ Use Production When:
  • Ready to accept real payments
  • Integration testing is complete
  • Going live with your application

Step 2: 🧪 Setting Up Sandbox Environment​

🧪Sandbox Environment Setup
⚠️IMPORTANT: Local Development Notice

If you're connecting from your local environment and can't receive responses, contact our technical team for network configuration assistance.

🔧 Step 2A: Configure Sandbox URLs​

🛒Sandbox Checkout URL:
https://sandbox.hesabe.com/checkout
💳Sandbox Payment URL:
https://sandbox.hesabe.com/payment

🔧 Step 2B: Access Sandbox Merchant Panel​

👤Login to Sandbox Merchant Panel
🔑 Username🔐 Password🌐 Portal URL
testTest@1234

merchant.hesbstaging.com/merchant

📝 Instructions:
  1. Click the portal URL above to open the merchant panel
  2. Enter username: test
  3. Enter password: Test@1234
  4. Navigate to Profile → API Credentials to view/manage keys

🔧 Step 2C: Use Sandbox API Credentials​

🔑Copy These Sandbox Credentials
🏷️ Parameter💾 Value📋 Action
Merchant Code842217
Access Codec333729b-d060-4b74-a49d-7686a8353481
Secret KeyPkW64zMe5NVdrlPVNnjo2Jy9nOb7v1Xg
IV Key5NVdrlPVNnjo2Jy9
Base URLhttps://sandbox.hesabe.com
📝 Usage Instructions:
  • Use these credentials in your development environment
  • All sandbox transactions are simulated - no real money involved
  • Test various payment scenarios safely
  • Monitor transactions in the sandbox merchant panel

Step 3: 🧪 Test Your Integration​

🧪Sandbox Testing Checklist
✅ Complete These Tests:
  • Authentication Test: Verify API credentials authenticate successfully
  • Payment Creation: Create test payment requests
  • Payment Processing: Complete payment flows with test cards
  • Callback Handling: Test payment status notifications
  • Error Scenarios: Test failed payments and edge cases
  • Refund Testing: Test refund functionality (if applicable)

Step 4: 🚀 Move to Production​

🚀Ready for Production?

Once sandbox testing is complete, follow our Production Migration Guide to go live with real payments.

📞 Support & Assistance​

🔧Technical Support:itsupport@hesabe.com
👤Merchant Support:support@hesabe.com