Developer Sandbox

Test Before You Go Live.

Validate your integration, test transaction flows and prepare your application for production.

Why Use the Sandbox

A Safe Space to Build & Validate.

Prepare your payment workflows in a controlled testing environment before enabling live transactions.

Controlled Testing

Test supported integration workflows using the designated sandbox environment, where available, without treating test activity as live financial processing.

Validate Different Scenarios

Review how your application handles successful responses, failed requests, pending statuses and other supported test outcomes.

Identify Issues Early

Find configuration errors, unexpected responses and integration gaps before they affect your live payment workflows.

sandbox-consoleTEST MODE
✓ Request sent
✓ Response received
● Status: pending
✓ Status check complete
✕ Validation error handled
✓ Retry rule verified
No live funds movedIllustrative
Testing Guide

From Setup to Production Readiness.

Move from initial setup to production readiness through four practical steps.

Get Sandbox Access

Confirm availability for your selected service and obtain authorised test credentials and environment details through the designated process.

Configure Your Application

Set up the required test environment, authentication and request parameters according to the applicable integration documentation.

Run & Review Test Cases

Check expected responses, transaction statuses, error handling and retry behaviour. Resolve identified issues before proceeding.

Prepare for Production

Complete the required checks and approvals, configure authorised production credentials and verify your live environment before launch.

What to Test

Cover Every Essential Integration Area.

Check the essential parts of your integration before moving towards production.

sandbox › integration reviewIllustrative
Test Scenarios

Prepared for More Than Just a Success.

Make sure your application is prepared for more than just a successful transaction.

SuccessIllustrative test result

Successful Response

Confirm that the transaction reference, response fields and resulting status are processed and recorded correctly.

What to verifyReference recorded · Status updated
PendingIllustrative test result

Pending or Delayed Response

Verify how your application checks the transaction status and communicates an unresolved outcome without incorrectly marking it as successful or failed.

What to verifyStatus check scheduled · Not marked final
FailedIllustrative test result

Failed Request

Check error handling, response interpretation and the next steps presented to the customer or operations team.

What to verifyError interpreted · Next step shown
Duplicate preventedIllustrative test result

Retry & Duplicate Prevention

Verify that repeated requests follow the documented retry and idempotency rules to help prevent unintended duplicate transactions.

What to verifyRetry rule applied · One transaction kept
Sandbox vs Production

Where Testing Ends, Live Processing Begins.

Understand where testing ends and live payment processing begins.

EnvironmentSandbox
TEST

Designed for testing and validation.

  • Test credentials, where providedsk_test_••••
  • Supported simulated scenariossuccess · pending · failed
  • Integration troubleshootinglogs & responses
  • Pre-launch validationbefore go-live
Authorised activation
Testing complete
Security checks
Required approvals
Production credentials
EnvironmentProduction
LIVE

For authorised live operations.

  • Approved production accessafter approval
  • Live transaction processingreal payments
  • Real operational monitoringlive status
  • Applicable service requirementsper agreement
Important

Sandbox outcomes may not match live bank or payment-network responses. Keep testing and production credentials separate, and follow the authorised activation process before processing live transactions.

Troubleshooting

Common Issues, Clear Next Steps.

Troubleshoot configuration and integration problems before they reach production.

Invalid Credentials

How to resolve

Verify the test credentials, authentication format and environment configuration against the official instructions.

Request Validation Errors

How to resolve

Check required fields, data types, accepted values and request formatting against the relevant API specification.

Unexpected Transaction Status

How to resolve

Review the response and follow the documented status-checking process. A timeout alone does not establish that a transaction has failed.

Callback Not Received

How to resolve

If callbacks are supported, verify endpoint availability, configuration and the documented process for investigating missed notifications.

Launch Readiness

Test Thoroughly. Launch with Confidence.

A reliable integration starts with careful validation. Use the available testing resources to review your transaction flows, identify issues and prepare your application for production.

Pre-launch sequence
Validate every supported workflow.Workflows validated
Keep credentials and test data secure.Credentials secured
Complete the required checks before launch.Checks completed
FAQs

Frequently Asked Questions.

Find answers to common questions about sandbox access, testing and production readiness.

Request Sandbox Access →
What is the Digiway Sandbox?

A sandbox is a testing environment intended to help developers validate an integration before production activation. Its available features and simulated transaction scenarios depend on the services supported by Digiway.

How can I request sandbox access?

Contact the Digiway team to confirm availability for your selected service. Follow the designated onboarding process to obtain authorised test credentials, environment details and any required approvals.

Do sandbox transactions move real money?

Sandbox transactions are intended for testing and may simulate transaction outcomes rather than transfer real funds. Confirm the capabilities of your assigned environment before running tests, and never assume a test result represents a live payment.

Can I test failed and pending transactions?

This depends on the scenarios supported by the sandbox. Refer to the relevant testing instructions for the available test cases and the approved way to simulate different transaction outcomes.

Do I need separate test and production credentials?

Follow the credential requirements specified by Digiway. Where separate credentials are provided, keep them isolated and never expose production secrets in test code, public repositories or client-side applications.

What should I do if a test request fails?

Review the response, authentication configuration, mandatory parameters and environment settings. Compare the request with the official API documentation. If the problem continues, contact technical support with a redacted error message and relevant reference.

Does successful sandbox testing guarantee successful live payments?

No. Sandbox testing validates integration behaviour, but live transactions may also depend on banks, payment networks, authentication, risk checks and other production conditions. Monitor live transactions carefully after activation.

How do I move from sandbox to production?

Complete the applicable testing, security checks and required approvals. Obtain authorised production credentials, verify the live configuration and confirm that your application handles transaction responses correctly before enabling live operations.

Where can I get help with sandbox configuration?

Contact the designated Digiway technical support channel. Include the relevant service, request reference and redacted error details. Do not share secret API keys, passwords, OTPs or sensitive customer information.

Developer Support

Resolve Issues Before You Launch.

Need assistance with sandbox access, configuration or an unexpected test result? Contact the Digiway team for guidance on the next steps.