Foundation

Environments

Foxpay provides dedicated base URLs for production, staging, and local development workflows. Pair each environment with the correct credential set and preserve the `testMode` value returned by the API for downstream handling.

Open the reference Review testing guidance

Production

https://app.foxpay.it/api

Staging

https://staging.app.foxpay.it/api

Local

http://localhost:3000/api

Environment usage

Use production for live merchant traffic and customer payments.
Use staging for end-to-end rehearsal, configuration validation, and pre-release verification.
Use local development for application integration and route wiring against your local environment.
Keep credentials isolated by environment and do not reuse live API keys in test-mode workflows.

Operational guidance

Persist `testMode` in your own order records so support and reconciliation flows can distinguish test traffic from live activity.
Validate the full buyer redirect and webhook path in the same environment before promoting changes.
Coordinate credential rotation and environment switches with your release process.
Use staging or controlled test-mode traffic to verify payment-method availability and merchant configuration before live rollout.