Skip to main content
The SmartRetry sandbox is a full simulation of the production environment. It lets you run API calls and validate response handling without processing real transactions.

​
Getting sandbox access

To get sandbox credentials, contact SmartRetry or request access through your account manager. You will receive a sandbox API Secret (starting with srk_test_) and a sandbox terminal ID to use during testing.

​
Authenticating in the sandbox

Authentication works the same way as production - sign each request with your API Secret and send the x-timestamp and x-signature headers. Your sandbox secret is separate from your production secret; make sure you are using the correct one for each environment. See Authentication for the signing steps.
Never use your production API Secret in sandbox testing, and never use your sandbox secret in production.

​
What you can test

The sandbox replicates the full production flow. Use it to verify:

API requests

Test sale, refund, and other payment endpoints using your sandbox terminal ID.

Response handling

Confirm your integration handles approved, declined, and error responses correctly.

Retry behavior

Observe how SmartRetry responds to declines and triggers retry logic.

Error scenarios

Simulate decline codes and validation errors to test your error handling paths.
Test both success paths and failure paths. Simulate declines to confirm your integration handles retry events, error codes, and fallback flows correctly - not just happy-path approvals.

​
Verifying your integration

After making requests in the sandbox, confirm SmartRetry is active and working by checking for retry events in your dashboard or API logs. Each retried transaction includes a reference to the SmartRetry process, along with timestamps and result details. If you are not seeing retries triggered as expected, contact support@smartretry.com and the team will review your integration.

​
Moving to production

Once you have validated your integration in the sandbox, follow these steps to go live:
1

Replace your API Secret

Sign requests with your production API Secret (starting with srk_live_) instead of your sandbox secret.
2

Update your terminal ID

Replace your sandbox terminal_friendly_id with your production terminal ID in all endpoint URLs.
3

Point to the production base URL

Confirm all requests go to https://terminal.smartretry.com. The sandbox and production environments share the same base URL - the API Secret and terminal ID determine which environment you are targeting.
4

Run a live test transaction

Process a low-value real transaction to confirm end-to-end connectivity before enabling full traffic.

​
Status page

Monitor the health of the SmartRetry API and infrastructure at status.smartretry.com. If you experience unexpected errors or connectivity issues, check the status page first before escalating to support.