Skip to main content

​
Environments

Wava provides separate environments for development and production use.

​
Base URLs

EnvironmentBase URLDashboardPurpose
Developmenthttps://api.dev.wava.co/v1app.dev.wava.coTesting and integration development
Productionhttps://api.wava.co/v1app.wava.coLive transactions with real money

​
Development environment

The development environment is a sandbox that mirrors production behavior without processing real payments. Use it to build and test your integration before going live. Key differences from production:
  • No real money is moved. All transactions are simulated.
  • Test phone numbers and document IDs can be used (see Test Data).
  • Nequi orders auto-confirm when you call GET /v1/orders/{orderId} (see Sandbox for details).
  • Daviplata orders accept test OTP codes.
  • Webhooks are sent to your configured development URL.
  • Rate limits are more permissive.
You receive a separate merchant-key for development when your account is created.

​
Getting your development credentials

  1. Go to https://app.dev.wava.co/ and create an account.
  2. Create a test store with test data.
  3. Fill the compliance form (no required fields in development).
  4. Navigate to Settings > Integrations > API to get your merchant key.
Direct link: https://app.dev.wava.co/config#integrations

​
Production environment

Production processes real payments. Before switching to production:
  1. Complete your integration testing in development.
  2. Follow the Go Live checklist.
  3. Submit your UX implementation for review.
  4. Switch your base URL and merchant key to production values.

​
Getting your production credentials

  1. Register your business at app.wava.co.
  2. Complete your business profile with required documentation.
  3. Get your production merchant key from app.wava.co/config#integrations.
Never use production credentials in development or testing. Use the development environment and its corresponding merchant key.