Wava Technologies

# 🚀 Wava Public API for Direct Order Processing

The Wava Public API enables merchants to create and process orders directly with immediate payment processing. This streamlined API is designed for merchants who want to integrate Wava's payment processing capabilities into their own checkout flows.

## 🎯 Key Features

- **Direct Order Creation**: Create orders instantly with payment processing
- **Multiple Payment Gateways**: Support for Nequi and Daviplata (Colombian mobile payments)
- **Real-time Status Updates**: Track order status changes via webhooks or polling
- **Secure Authentication**: Merchant key-based authentication for secure API access
- **Comprehensive Error Handling**: Detailed error codes and messages for easy debugging

## 🔐 Authentication

All API requests require authentication using a merchant key provided in the request header:

```
merchant-key: YOUR_MERCHANT_KEY
```

Contact Wava support to obtain your merchant key and configure your store for API access.

## 🌍 Base URL

**Production**: `https://api.wava.co`
**Development**: `https://api.dev.wava.co`

## 📊 Supported Payment Gateways

| Gateway | Description | Supported Currencies | Requirements |
|---------|-------------|---------------------|--------------|
| **Nequi** | Colombian mobile wallet | COP | Phone number |
| **Daviplata** | Colombian digital wallet | COP | National ID + Document type |

## 🔄 Payment Flows

### Nequi Flow
1. Create order with phone number
2. User receives push notification on their phone
3. User approves payment in Nequi app
4. Webhook notification sent to merchant
5. Order status updates to 'confirmed'

### Daviplata Flow
1. Create order with national ID
2. User receives OTP via SMS
3. Submit OTP to complete payment
4. Order status updates to 'confirmed'

## 🧪 Testing

Use the following test data in development environment:

### Daviplata Test IDs
- **12345678** (CC) - Success flow
- **11111111** - User not found error
- **22222222** - Invalid document error
- **33333333** - Invalid amount error

### Daviplata Test OTPs
- **123456** - Always valid
- **000000** - Always valid
- **111111** - Always valid


Wava Public API

Authentication

**Gateway Discovery and Configuration**

Operations for retrieving available payment gateways and their configurations.
Use these endpoints to discover which payment methods are available for your store
and understand their specific requirements.

**Key Features:**
- Get all available payment gateways
- Gateway-specific requirements (phone, national ID)
- Currency support information
- Direct API support indicators
- Gateway logos and descriptions

**Use Cases:**
- Display payment options in checkout
- Validate requirements before order creation
- Build dynamic payment forms
- Gateway availability checking


Payment Gateways

Retrieve the list of payment gateways available for your store. This endpoint returns
all active payment gateways configured for your store, regardless of amount limits.

Amount-specific validation (min/max limits) is performed during order creation,
not during gateway discovery.

**Use this endpoint to:**
- Display all available payment options to customers
- Get gateway-specific requirements (phone, national ID, etc.)
- Get gateway logos and descriptions for UI display
- Understand which gateways support direct API orders


Get available payment gateways

**Complete Order Lifecycle Management**

Core order management operations covering the entire lifecycle from creation to completion.
These endpoints handle direct payment processing, status tracking, and order operations.

**Key Features:**
- Direct order creation with immediate processing
- Real-time order status tracking
- Order cancellation and refund management
- Daviplata OTP handling
- Webhook notifications support

**Supported Payment Flows:**
- **Nequi**: Push notification approval
- **Daviplata**: SMS OTP verification

**Order Statuses:**
- `pending` → `processing` → `confirmed`
- `cancelled` (for rejected/timeout)
- `refunded` (for completed refunds)


Orders

Create and process an order directly with immediate payment processing.

This endpoint handles the complete flow from order creation to payment initiation.

**Supported Payment Gateways:**
- **Nequi**: Requires phone number
- **Daviplata**: Requires national ID and document type

### Nequi Requirements
- `payment_gateway.phone_number` (10 digits, Colombian format)
- User receives push notification for payment approval

### Daviplata Requirements  
- `payment_gateway.national_id_number` (numeric)
- `payment_gateway.id_national_document_type` (document type ID)
- ID must be registered with Daviplata


Create direct order

Retrieve detailed information about a specific order, including current status,
payment information, and transaction history.

**Access Levels:**
- **Merchants**: Access orders from their store
- **Admins**: Full access to all orders
- **Guests**: Limited access for checkout flows

**Response Data:**
- Order status and timestamps
- Payment gateway information (masked sensitive data)
- Transaction history (if requested)
- Customer information (based on access level)


Get order details

Complete a Daviplata payment by submitting the OTP (One-Time Password) received via SMS.
This endpoint is only used for Daviplata payments that require OTP verification.

**Flow:**
1. Create order with Daviplata payment gateway
2. User receives OTP via SMS from Daviplata
3. Submit OTP using this endpoint
4. Payment is processed and order status updated

**Development Testing:**
Use these OTP codes in sandbox environment:
- `123456` - Always succeeds
- `000000` - Always succeeds  
- `111111` - Always succeeds
- Any other code - Returns invalid OTP error


Submit Daviplata OTP

Cancel an existing order. Orders can only be cancelled if they are in 'pending' 
or 'processing' status. Confirmed orders cannot be cancelled - use refund instead.

**Permissions:**
- Merchants can cancel orders from their store
- Admins can cancel any order
- Users can cancel their own orders

**Note:** Cancelling an order will also cancel any pending payment transactions.


Cancel an order

Process a refund for a confirmed order. Refunds are only available for orders
that are in 'confirmed' status and within the 96-hour refund window.

**Refund Policy:**
- Orders must be confirmed
- Refunds must be requested within 96 hours of purchase
- Full refund only (partial refunds not supported)

**Permissions:**
- Merchants can refund orders from their store
- Admins can refund any order
- Users can refund their own orders


Refund an order

Webhooks

**Supporting Data and Configuration**

Helper endpoints that provide supporting data required for payment processing.
These endpoints help you build complete, localized payment forms.

**Available Data:**
- National document types by country
- Supported currencies and formats
- Country-specific validation rules

**Integration Purpose:**
- Populate form dropdowns
- Validate user input
- Localize payment forms
- Support multiple countries


Utilities

Retrieve the list of valid national document types for a specific country.
Use this endpoint to populate document type dropdowns for Daviplata payments.


Get document types by country

Nequi Payment Flow

Daviplata Payment Flow

Error Codes

Authentication Errors (1000-1099)

Validation Errors (2000-2099)

Orders Errors (3000-3099)

Payment Processing Errors (4000-4099)

Gateway Specific Errors (6000+)

Development testing

Go Live

Default

Production

Production server

Development server

Sandbox

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Description</h2><p class="slate-p " >The Wava Public API enables merchants to create and process orders directly with immediate payment processing. This streamlined API is designed for merchants who want to integrate Wava&apos;s payment processing capabilities into their own checkout flows.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >🎯 Key Features</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Direct Order Creation</strong>: Create orders instantly with payment processing</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Multiple Payment Gateways</strong>: Support for Nequi and Daviplata (Colombian mobile payments)</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Real-time Status Updates</strong>: Track order status changes via webhooks or polling</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Secure Authentication</strong>: Merchant key-based authentication for secure API access</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Comprehensive Error Handling</strong>: Detailed error codes and messages for easy debugging</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >🔐 Authentication</h2><p class="slate-p " >All API requests require authentication using a merchant key provided in the request header:</p><div class="code-block-wrapper"  style="width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden">merchant-key: YOUR_MERCHANT_KEY </textarea><code class="language-plainText keep-markup drop-tokens"></code></pre></div><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >This Merchant Key can be find in your dashboard.</p></div></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >📊 Supported Payment Gateways</h2><p class="slate-p " ></p><div class="table-container" style="width:98%;
  min-width:98%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:100px;">Name</div><div style="width:100px;">Description</div><div style="width:100px;">Currencies</div></div><colgroup ><col style="width:initial"><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Nequi</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Colombia&apos;s Digital Wallet from Bancolombia with 20M+ users</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >COP</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Daviplata</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Colombia&apos;s Digital Wallet from Davivienda with 17M+ users</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >COP</p></td></div></tr></tbody></table></div><p class="slate-p " ></p>

The Wava Public API enables merchants to create and process orders directly with immediate payment processing. This streamlined API is designed for merchants who want to integrate Wava's payment processing capabilities into their own checkout flows.

All API requests require authentication using a merchant key provided in the request header:

Name

Description

Currencies

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Description</h2><p class="slate-p " >Authentication to the API is achieved using the merchant-key header which differs from Development and Production environments. This key can be found in you account&apos;s dashboards depending on the environment:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Development:</strong> <a href="https://app.dev.wava.co/config#integrations" target="_self">https://app.dev.wava.co/config#integrations</a></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Production:</strong> <a href="https://app.wava.co/config#integrations" target="_self">https://app.wava.co/config#integrations</a></div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Create development account</h2><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Go to https://app.dev.wava.co/</div></li><li class="slate-li " ><div style="position:relative">Use you email to access</div></li><li class="slate-li " ><div style="position:relative">Create a test Store with test data</div></li><li class="slate-li " ><div style="position:relative">Fill the compliance form with test data, there are no required fields</div></li><li class="slate-li " ><div style="position:relative">Upon activation navigate the config section</div></li><li class="slate-li " ><div style="position:relative">In the Integrations tab, under API, you&apos;ll get the merchant key for this environment1</div></li></ol><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Visual reference</h2><div style="text-align:left"><img src="https://d24lr4zqs1tgqh.cloudfront.net/49fe05f7-ad23-40ec-9396-602d67dd67b3.jpg" style="
              width:896px;
	            height:678px;
	            aspect-ratio:896 / 678"
         /></div><p class="slate-p " ></p>

Authentication to the API is achieved using the merchant-key header which differs from Development and Production environments. This key can be found in you account's dashboards depending on the environment:

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Description</h2><p class="slate-p " >Payment gateways are configured for each account and depends on Country and Currencies available for it&apos;s account.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Requirements</h2><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=warning ><div class="callout-icon"><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p " >Each Gateway needs to be displayed with the correspondent logo provided by the API and require for the information specified in the API response.</p></div></div><p class="slate-p " ></p>

Payment gateways are configured for each account and depends on Country and Currencies available for it's account.

<p class="slate-p " >Retrieve the list of payment gateways available for your store. This endpoint returns
all active payment gateways configured for your store, regardless of amount limits.</p><p class="slate-p " >Amount-specific validation (min/max limits) is performed during order creation,
not during gateway discovery.</p><p class="slate-p " ><strong class="slate-bold">Use this endpoint to:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Display all available payment options to customers</div></li><li class="slate-li " ><div style="position:relative">Get gateway-specific requirements (phone, national ID, etc.)</div></li><li class="slate-li " ><div style="position:relative">Get gateway logos and descriptions for UI display</div></li><li class="slate-li " ><div style="position:relative">Understand which gateways support direct API orders</div></li></ul><p class="slate-p " ></p>

Retrieve the list of payment gateways available for your store. This endpoint returns
all active payment gateways configured for your store, regardless of amount limits.

Amount-specific validation (min/max limits) is performed during order creation,
not during gateway discovery.

merchant-key

Filter payment gateways by currency (defaults to store currency)

currency

data

code

api_code

message

description

error

Payment gateway name (for gateway errors)

gateway_name

Currency provided in request (for currency errors)

provided_currency

supported_currency

validation_errors

Authentication required or invalid merchant key

<p class="slate-p " ><strong class="slate-bold">Complete Order Lifecycle Management</strong></p><p class="slate-p " >Core order management operations covering the entire lifecycle from creation to completion.
These endpoints handle direct payment processing, status tracking, and order operations.</p><p class="slate-p " ><strong class="slate-bold">Key Features:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Direct order creation with immediate processing</div></li><li class="slate-li " ><div style="position:relative">Real-time order status tracking</div></li><li class="slate-li " ><div style="position:relative">Order cancellation and refund management</div></li><li class="slate-li " ><div style="position:relative">Daviplata OTP handling</div></li><li class="slate-li " ><div style="position:relative">Webhook notifications support</div></li></ul><p class="slate-p " ><strong class="slate-bold">Supported Payment Flows:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Nequi</strong>: Push notification approval</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Daviplata</strong>: SMS OTP verification</div></li></ul><p class="slate-p " ><strong class="slate-bold">Order Statuses:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">pending</code> → <code class="slate-code">processing</code> → <code class="slate-code">confirmed</code></div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">cancelled</code> (for rejected/timeout)</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">refunded</code> (for completed refunds)</div></li></ul><p class="slate-p " ></p>

Core order management operations covering the entire lifecycle from creation to completion.
These endpoints handle direct payment processing, status tracking, and order operations.

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Description</h2><p class="slate-p " >Helper endpoints that provide supporting data required for payment processing. These endpoints help you build complete, localized payment forms.</p><p class="slate-p " ><strong class="slate-bold">Available Data:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">National document types by country</div></li><li class="slate-li " ><div style="position:relative">Supported currencies and formats</div></li><li class="slate-li " ><div style="position:relative">Country-specific validation rules</div></li></ul><p class="slate-p " ><strong class="slate-bold">Integration Purpose:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Populate form dropdowns</div></li><li class="slate-li " ><div style="position:relative">Validate user input</div></li><li class="slate-li " ><div style="position:relative">Localize payment forms</div></li><li class="slate-li " ><div style="position:relative">Support multiple countries</div></li></ul><p class="slate-p " ></p>

Helper endpoints that provide supporting data required for payment processing. These endpoints help you build complete, localized payment forms.

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Description</h2><p class="slate-p " >Nequi is Bancolombia&apos;s leading digital wallet. The integration requires only the customer&apos;s phone number to initiate payments.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Customer Experience</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Customer receives push notification on their phone</div></li><li class="slate-li " ><div style="position:relative">Opens Nequi app to review payment details</div></li><li class="slate-li " ><div style="position:relative">Confirms or rejects the payment within the Nequi App</div></li><li class="slate-li " ><div style="position:relative">Receives confirmation within the app</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Suggested UX implementation</h2><h3 class="slate-h3 " >Show the steps for the user</h3><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Recibirás una notificación push en tu teléfono</div></li><li class="slate-li " ><div style="position:relative">Revisa los datos y acepta el cobro</div></li><li class="slate-li " ><div style="position:relative">Tu compra se procesará automáticamente</div></li></ol><h3 class="slate-h3 " >Use the following gif to give better context to the user</h3><p class="slate-p " >https://wava-assets.s3.us-east-1.amazonaws.com/payment-gateways/nequi-flow-2025.gif</p><div style="text-align:left"><img src="https://wava-assets.s3.us-east-1.amazonaws.com/payment-gateways/nequi-flow-2025.gif" style="
              width:254px;
	            height:209px;
	            aspect-ratio:254 / 209"
         /></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Payment Process</h2><p class="slate-p " ></p><div style="text-align:left"><img src="https://d24lr4zqs1tgqh.cloudfront.net/2f9937ca-bd17-45f8-801e-416cf2f44485.png" style="
              width:1497px;
	            height:2043px;
	            aspect-ratio:1497 / 2043"
         /></div><p class="slate-p " ></p><p class="slate-p " ></p>

Nequi is Bancolombia's leading digital wallet. The integration requires only the customer's phone number to initiate payments.

Use the following gif to give better context to the user

https://wava-assets.s3.us-east-1.amazonaws.com/payment-gateways/nequi-flow-2025.gif

Daviplata is Davivienda's digital wallet. Integration requires customer's national ID and document type for payment processing.

https://wava-assets.s3.us-east-1.amazonaws.com/payment-gateways/daviplata-flow-2025.gif

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Description</h3><p class="slate-p " >All Wava API errors follow a standardized JSON format that provides detailed information for debugging and user experience handling.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Standard Error Response</h2><div class="code-block-wrapper"  style="width:60%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
  &quot;code&quot;: 4005,
  &quot;api_code&quot;: &quot;PAYMENT_GATEWAY_VALIDATION&quot;,
  &quot;message&quot;: &quot;Payment gateway validation failed&quot;,
  &quot;description&quot;: &quot;The payment gateway information provided is invalid or incomplete&quot;,
  &quot;error&quot;: true,
  &quot;validation_errors&quot;: [
    {
      &quot;field&quot;: &quot;payment_gateway.phone_number&quot;, 
      &quot;message&quot;: &quot;Phone number is required for Nequi payments&quot;,
      &quot;value&quot;: null
    }
  ]
}</div></div></code></pre></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><p class="slate-p " ></p>

All Wava API errors follow a standardized JSON format that provides detailed information for debugging and user experience handling.

The payment gateway information provided is invalid or incomplete

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " >Description</h2><p class="slate-p " >Use these test values in development to trigger specific error responses.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h1 class="slate-h1 " >Daviplata</h1><p class="slate-p " ><strong class="slate-bold">OTP Testing:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Invalid OTP:</strong> Use <code class="slate-code">&quot;999999&quot;</code> to trigger OTP error</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Valid Test OTPs:</strong> <code class="slate-code">&quot;123456&quot;</code>, <code class="slate-code">&quot;000000&quot;</code>, or <code class="slate-code">&quot;111111&quot;</code> always work in development</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h1 class="slate-h1 " >Nequi</h1><p class="slate-p " >All nequi transactions will be processed by calling the getOrder endpoint providing the ID. This call will respond with confirmed status and send the webhook. </p><p class="slate-p " ></p>

Use these test values in development to trigger specific error responses.

All nequi transactions will be processed by calling the getOrder endpoint providing the ID. This call will respond with confirmed status and send the webhook. 

<div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Overview</h3><p class="slate-p " >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.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Prerequisites</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Completed integration testing in development environment</div></li><li class="slate-li " ><div style="position:relative">Valid business registration in Colombia</div></li><li class="slate-li " ><div style="position:relative">Implementation of at least one payment gateway (Nequi or Daviplata)</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >Obtain Production Merchant Key</h3><h3 class="slate-h3 " ></h3><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Register your business</strong> at <a href="https://app.wava.co" target="_blank">app.wava.co</a></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Complete your business profile</strong> with required documentation</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Get production merchant key</strong> through the dashboard same as did for development</div></li></ol></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >UX Flow Documentation</h3><p class="slate-p " >Before going live, you must submit visual documentation of your payment implementation for approval.</p><p class="slate-p " ><strong class="slate-bold">Required Documentation:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Complete user journey screenshots</strong> from payment initiation to confirmation</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Each implemented payment gateway</strong> must be documented separately</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Mobile and desktop views</strong> if applicable</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Error handling scenarios</strong> (optional but recommended)</div></li></ul><p class="slate-p " ><strong class="slate-bold">Screenshot or Video evidence:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">High-quality images showing the complete flow</div></li><li class="slate-li " ><div style="position:relative">Include payment gateway selection, amount display, and confirmation screens</div></li><li class="slate-li " ><div style="position:relative">Show payment gateway logos as implemented</div></li><li class="slate-li " ><div style="position:relative">Demonstrate proper loading states and user feedback</div></li></ul></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >Submit for Review</h3><p class="slate-p " ><strong class="slate-bold">Email Submission:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">To:</strong> <a href="mailto:go-live@wava.co" target="_blank">go-live@wava.co</a></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Subject:</strong> Production Approval Request - [Your Business Name]</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Include:</strong> </div></li><li class="slate-li " ><div style="position:relative">Business name and merchant ID</div></li><li class="slate-li " ><div style="position:relative">Website/app URL where integration is implemented (If applicable)</div></li><li class="slate-li " ><div style="position:relative">Payment gateways implemented (Nequi, Daviplata, or both)</div></li><li class="slate-li " ><div style="position:relative">Screenshots or video evidences</div></li><li class="slate-li " ><div style="position:relative">Expected go-live date</div></li></ul><p class="slate-p " ><strong class="slate-bold">Review Process:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Initial review:</strong> 2-3 business days</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Feedback:</strong> If changes are needed, we&apos;ll provide specific guidance</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Approval:</strong> Once approved, your merchant key will be activated for production</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Go-live support:</strong> Technical support available during your launch</div></li></ul><p class="slate-p " ></p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >4</h6><h3 class="slate-h3 " >Production Activation</h3><p class="slate-p " ></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Switch to production URLs</strong> in your integration</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Update merchant key</strong> to your activated production key</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Test with small transactions</strong> to verify everything works correctly</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Monitor your first transactions</strong> through the Wava dashboard</div></li></ol><p class="slate-p " ></p></div></div></div><p class="slate-p " ></p><h3 class="slate-h3 " >Support During Go-Live</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Technical support:</strong> Available during business hours (8 AM - 6 PM COT)</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Emergency contact:</strong> Provided after approval for critical issues</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Dashboard monitoring:</strong> Real-time transaction monitoring available</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Integration assistance:</strong> integrations@wava.co</div></li></ul><h3 class="slate-h3 " >Business Hours &amp; Response Times</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Review submissions:</strong> Monday - Friday, 8 AM - 6 PM (COT)</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Approval timeline:</strong> 2-3 business days for standard integrations</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Support response:</strong> &lt; 2 hours during business hours</div></li></ul><p class="slate-p " ></p>

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.

Sections