Orcuspay separates test and live data. Use test mode while building and switch to live mode only after your checkout flow is verified.

​
Key prefixes

​
Test mode

Use test mode to:
  • Configure a new module.
  • Test checkout redirects.
  • Test payment links.
  • Test webhook/IPN delivery.
  • Train your team without creating live payments.
Test payments are isolated from live payments.

​
Live mode

Use live mode only when:
  • Test checkout succeeds.
  • Webhook/IPN updates the order or invoice correctly.
  • You have configured your live payment methods.
  • Your domain and callback URLs use HTTPS.

​
Switching from test to live

New businesses start in test mode, and the mode switch stays locked until your business is verified.
  1. Build and test your integration with your test keys (ak_test_ / sk_test_).
  2. Verify your business: open Settings → Verification and complete identity verification.
  3. Once you are verified, the Test mode toggle in the top navigation bar unlocks.
  4. Turn Test mode off to switch the dashboard to live mode. The dashboard now shows live data, and Developers → API keys shows your live keys (ak_prod_ / sk_prod_).
  5. Replace the test keys in your integration with the live keys.
You can switch back to test mode at any time with the same toggle.

​
Testing a payment

  1. Keep Test mode on (it is on by default).
  2. Add and enable the payment methods you want to test under Settings → Payment methods. Test-mode payment methods are configured separately from live ones, so adding a method in test mode never affects live.
  3. Create a checkout session or payment link as usual and complete it. Test payments are isolated from live payments and never move real money.
  4. For Dakpion (personal-account automation), add the payment method in test mode and forward a matching payment SMS — a genuine, matching SMS marks the test payment as paid.
There is no single universal test wallet number: gateway methods (SSLCommerz, Stripe, etc.) use each provider’s own sandbox test credentials.

​
Common mistakes

  • Using a test access key with a live secret key.
  • Creating the webhook in live mode but testing with test keys.
  • Copying the wrong webhook signing secret.
  • Changing the dashboard domain without updating module settings.
  • Dropping the /v1 from the API base URL. Every REST call and SDK uses https://brain.orcuspay.com/api/v1; https://brain.orcuspay.com/api (without /v1) will not work.