Skip to main content

Environments & base URLs

MidasPay exposes two fully isolated environments. Use sandbox for every integration and QA activity; only switch the base URL and credentials once your integration is certified for production.

Base URLsโ€‹

EnvironmentAPI base URLPurpose
๐Ÿงช Sandboxhttps://sandbox-pay.centauriglobal.comIntegration, QA, automated testing
๐ŸŸข Productionhttps://pay.midaspayment.comLive traffic, real money

Each reference page's "Try it" console is configured with the correct base URLs, so you can target either environment directly from this site.

Data isolationโ€‹

  • Sandbox and production do not share any data โ€” orders, merchants, credentials, webhooks and reports live in separate databases.
  • Credentials are environment-specific. A sandbox certificate / key-pair is useless in production, and vice versa. Generate a fresh pair when you promote.
  • Webhook URLs are configured per environment (commonly webhooks.dev.example.com vs webhooks.example.com).

Promotion workflowโ€‹

Before you receive production credentials, your MidasPay merchant manager will typically walk through a readiness review covering:

  • At least one end-to-end happy-path transaction in sandbox.
  • At least one declined transaction handled correctly in your code.
  • Webhook endpoint verifies the signature and returns 2xx promptly with a {"processed": true} body.
  • Idempotency (correct use of reference_id) observed under duplicate-request simulation.
  • Refund / void flows exercised where applicable.
  • PCI-DSS attestation on file if your integration sees card data.

Differences you should knowโ€‹

AspectSandboxProduction
Rate limitsLower than productionSet contractually
Channel coverageA subset of channels, each with sandbox test credentialsAll contracted channels
3DS challengeSimulated by the channel's sandboxReal issuer ACS
SettlementNone โ€” test moneyReal settlement to your bank account
Support SLABest-effort during business hoursAs specified in your contract

For exact numbers (quotas, retries, retention) in either environment, consult the Merchant Portal or your merchant manager โ€” published figures depend on your contract and region.

Operational notesโ€‹

  • Credential updates (uploading a new certificate, rotating a key) propagate within the Merchant Portal. Allow a short grace period before exercising the new credential in production.
  • Scheduled maintenance is announced in advance by email to the merchant's technical contact.