Skip to main content

Introduction

Introduction​

PayWise integration now follows a simple sequence:

Developer -> Identity -> Sandbox Console -> API

PayWise Identity handles sign-in, Sandbox Console handles sandbox API key management and onboarding, and API endpoints execute business operations. This portal is designed to move your team from first request to production launch with consistent patterns.

  1. Sign in via Identity and use sandbox hosts.
  2. Obtain your first sandbox API key via Sandbox Console.
  3. Build request/response envelope handling (including error + retry paths).
  4. Implement idempotency for all mutating requests.
  5. Wire your monitoring with request IDs and failure classifications.
  6. Promote to production with controlled traffic and rollback readiness.

Fastest path: your first sandbox payment​

  1. Open Sandbox Dashboard: https://sandbox-dashboard.paywise.co
  2. Create sandbox personal + business test accounts
  3. Install the Sandbox PayWise App: https://docs.paywise.co/getting-started/sandbox-app
  4. Sign in as the sandbox business user (OTP 123456)
  5. Copy the business api_key from the portal credentials area
  6. Generate or use your sandbox pw-subscription-key
  7. Open Checkout Builder: https://sandbox-dashboard.paywise.co/studio/checkout/payload-builder
  8. Send a test payment request
  9. Check status with GET /payments/status
  10. View recent requests in Transactions and Logs

Notes:

  • Payments API checkout does not require direct Account API access.
  • Account API access (/account/*) is restricted and requires PayWise approval. Portal-created sandbox test accounts do not grant Account API access.
  • Sandbox account setup explainer: /getting-started/sandbox-account-setup

Ready to go live?​

After sandbox success, follow the production readiness checklist before sending live payments:

https://docs.paywise.co/getting-started/go-live-checklist

Sandbox App OTP Note​

If you are testing with the Sandbox App and receive an in-sandbox push-notification OTP prompt, the default sandbox OTP is:

123456

Use 123456 for sandbox OTP prompts unless PayWise explicitly provides a different test code for a specific flow.

Baseline integration checklist​

  • Environment-aware base URL handling
  • Key rotation plan
  • Replay-safe mutation flow (idempotency)
  • 429/5xx backoff and jitter
  • Audit logging for request IDs

Environment roles​

  • sandbox-admin.paywise.co provisions access for sandbox-dashboard.paywise.co.
  • admin.paywise.co provisions access for dashboard.paywise.co.