Sandbox

Learn how to create and use a sandbox account for testing your HitPay integrations

Sandbox Environment

The HitPay sandbox environment allows developers to simulate payment flows without processing real transactions. It is essential for testing and debugging before moving to production.

Important Notes

• Sandbox and production are completely separate accounts
• You can use dummy business details when signing up for sandbox
• No verification or approval is required
• Choose Singapore as your business country
• The only payment methods supported in sandbox are PayNow and cards

Creating a Sandbox Account

1. Sign Up for a Sandbox Account

   Visit the Sandbox Account Creation Page and enter test details (no real data required). Verify your email address to activate the account.

2. Access the Sandbox Dashboard

   Log in at https://dashboard.sandbox.hit-pay.com/login. The interface is identical to production, but uses test data.

3. Set Up Payment Methods

   Go to Settings → Payment Methods and enable PayNow and Card Payments for testing. Other payment methods are not available in sandbox.

4. Generate API Keys

   Navigate to Settings → API Keys and generate new keys for use in development. Use these only with the sandbox API URL.

Sandbox Features

Supported Payment Methods

• Credit and debit cards
• PayNow (via QR code)

Simulated Behavior

• All transactions are test-only; no real charges occur
• Webhook events are triggered to your test endpoints
• API responses mirror the production system

Test Cards

Use the following card numbers to simulate various payment outcomes:

Card Type	Number	Expiry	CVC	Description
Visa	4242 4242 4242 4242	Any future date	Any 3 digits	Successful payment
Visa (Declined)	4000 0000 0000 0002	Any future date	Any 3 digits	Declined transaction
Mastercard	5555 5555 5555 4444	Any future date	Any 3 digits	Successful payment
American Express	3782 822463 10005	Any future date	Any 4 digits	Successful payment

Test PayNow

To simulate a PayNow payment:

• Start a transaction using the sandbox dashboard or API
• When prompted, a QR code will be generated
• Use your mobile phone camera (not the PayNow app) to scan the QR code
• The transaction will automatically simulate a successful payment

Webhook Configuration

• Use separate webhook URLs for sandbox and production environments
• Webhooks in sandbox are sent to your test endpoints
• Webhooks in production are sent to your live endpoints

IP Addresses to Allowlist
If your system requires allowlisting for incoming webhooks, ensure the following IPs are permitted:

• Production Webhooks: 3.1.13.32, 52.77.254.34
• Sandbox Webhooks: 54.179.156.147

Switching Between Sandbox and Production

# API Endpoints and Variables

# Sandbox
HITPAY_API_KEY=your_sandbox_api_key
HITPAY_API_URL=https://api.sandbox.hit-pay.com

# Production
HITPAY_API_KEY=your_production_api_key
HITPAY_API_URL=https://api.hit-pay.com

FAQs

How do I test for payment methods that are outside of Singapore?

Currently, it’s a limitation of the sandbox, and we are working to improve this. But all payment methods work exactly the same when it comes to integration. So if you can integrate with PayNow or cards using a Singapore business, all you need to do is switch to other methods in production by replacing the payment method parameter.

How do I test other payment methods apart from PayNow and cards?

Currently, it’s a limitation. The sandbox environment only supports PayNow and card payments for testing purposes. However, all payment methods work exactly the same when it comes to integration. So if you can integrate with PayNow or cards using a Singapore business, all you need to do is switch to other methods in production by replacing the payment method parameter.

Can I convert my Sandbox account to production?

No, they are separate accounts. Sandbox and production environments are completely independent, and you cannot convert between them. You’ll need to create a separate production account when you’re ready to go live.