Skip to main content

Sandbox Environment

The development environment at https://api.dev.wava.co/v1 is a full sandbox that simulates payment processing without moving real money.

What is simulated

  • Order creation and status transitions
  • Payment gateway responses (push notifications, OTP codes, QR codes)
  • Webhook delivery to your development endpoint
  • All error scenarios

Getting started

  1. Create a development account at app.dev.wava.co (see Authentication).
  2. Get your development merchant-key from Settings > Integrations > API.
  3. Point your API calls to https://api.dev.wava.co/v1.
  4. Use the test data values for phone numbers, national IDs, and OTP codes.

Gateway-specific testing behavior

Nequi (auto-confirm via GET)

In development, Nequi push notifications are simulated. To confirm a Nequi order, call the get order endpoint with the order ID. This call will automatically confirm the order and trigger the webhook.

Daviplata (test OTPs)

Daviplata orders work the same as production, but use test OTP codes:

Breb

Breb orders return simulated QR codes and transfer keys. The order can be confirmed via polling or webhook.

Differences from production