Skip to main content

​
Go Live

Before your integration can process live payments, Wava requires activation of your account and approval of your payment flow implementation to ensure the best customer experience.

​
Prerequisites

  • Completed integration testing in development environment
  • Valid business registration in Colombia
  • Implementation of at least one payment gateway (Nequi, Daviplata, or Breb)

​
Step 1: Set up your account

1

Register your business

Register your business at app.wava.co.
2

Complete your business profile

Complete your business profile with required documentation.

​
Step 2: Technical requirements

1

Integration testing complete

All payment flows tested successfully in the development environment, including success, failure, and cancellation scenarios for each gateway you plan to use.
2

Webhook endpoint configured

Your production webhook URL is set up, responding with 200 OK, and handling all relevant event types. See Webhooks.
3

Error handling implemented

Your integration gracefully handles API errors, network timeouts, and unexpected responses. See Error Handling.
4

Idempotency

Your system uses order_key to prevent duplicate orders from retries or network issues.
5

Server-side API calls

All API calls are made from your backend. No merchant keys are exposed in client-side code.

​
Step 3: UX flow documentation

Before going live, you must submit visual documentation of your payment implementation for approval.

​
Required documentation

  • Complete user journey screenshots from payment initiation to confirmation
  • Each implemented payment gateway must be documented separately
  • Mobile and desktop views if applicable
  • Error handling scenarios (optional but recommended)

​
Screenshot or video evidence

  • High-quality images showing the complete flow
  • Include payment gateway selection, amount display, and confirmation screens
  • Show payment gateway logos as implemented
  • Demonstrate proper loading states and user feedback

​
Step 4: Submit for review

Send your submission via email:
  • To: go-live@wava.co
  • Subject: Production Approval Request - [Your Business Name]
Include the following:
  • Store name / business name
  • Registered email address
  • Website/app URL where integration is implemented (if applicable)
  • Payment gateways implemented (Nequi, Daviplata, Breb, or all)
  • Screenshots or video evidence
  • Expected go-live date

​
Review process

  • Initial review: 2-3 business days
  • Feedback: If changes are needed, we’ll provide specific guidance
  • Approval: Once approved, your merchant key will be activated for production
  • Go-live support: Technical support available during your launch

​
Step 5: Production activation

1

Switch to production URLs

Update your base URL from https://api.dev.wava.co/v1 to https://api.wava.co/v1.
2

Get your production merchant key

Once your account is approved, your production merchant key will be available in the Wava dashboard. Go to Settings > Integrations > API to retrieve it.
3

Update merchant key

Replace your development merchant key with your activated production key.
4

Update webhook URL

Configure your production webhook endpoint in the dashboard.
5

Test with small transactions

Verify everything works correctly with small real payments.
6

Monitor your first transactions

Use the Wava dashboard to monitor your first live transactions.

​
Support during go-live

  • Technical support: Available during business hours (8 AM - 6 PM COT, Monday - Friday)
  • Response time: Less than 2 hours during business hours
  • Emergency contact: Provided after approval for critical issues
  • Dashboard monitoring: Real-time transaction monitoring available
  • Integration assistance: integrations@wava.co
Your integration must be reviewed and approved by the Wava team before going live. Contact soporte@wava.co if you have any questions about the process.