Deuna App Wallet

Getting Started with Deuna App Wallet

Deuna App Wallet is a digital wallet payment method available in Ecuador that enables customers to pay using the Deuna App through Deuna platform.

⚠️

Important Nomenclature

• Deuna = The payment orchestration platform you are integrating with
• Deuna App Wallet = The external wallet APM (payment method) you are integrating into your checkout

How It Works

Deuna App Wallet allows customers to complete purchases by opening the Deuna App on their mobile device and confirming payment using one of two methods:

Payment Methods

Numeric Code Mode

• Customer receives a 6-digit numeric code
• Code must be entered in the Deuna App within 3 minutes
• Customer confirms payment in the app
• Real-time confirmation via webhook

QR Code Mode

• Customer receives a dynamic QR code
• Code can be scanned with the Deuna App or clicked to open directly
• Valid for 15 minutes
• Real-time confirmation via webhook

Both modes use webhook-based confirmation with polling fallback for reliability.

Requirements

To successfully integrate Deuna App Wallet, ensure you have:

Technical Requirements

• Deuna SDK integrated in your project
• Order token generation capability via Deuna API
• Payment Widget implementation (or direct API integration)
• Webhook endpoint configured to receive payment confirmations

Configuration Requirements

• Deuna App Wallet enabled in your Deuna Admin Panel
• Payment mode selected (Numeric Code or QR Code)
• Merchant credentials and API keys configured

Merchant Requirements

• Active Deuna merchant account
• Ecuador merchant location
• USD currency enabled

Customer Requirements

• Deuna App installed on mobile device
• Active Deuna App account
• Located in Ecuador

Supported Regions & Currencies

Payment Flow Overview

1. Customer initiates checkout
   ↓
2. Selects "Pay with Deuna App Wallet"
   ↓
3. Deuna generates payment request (code or QR)
   ↓
4. Customer opens Deuna App & confirms payment
   ↓
5. Webhook notifies Deuna of confirmation
   ↓
6. Order marked as paid, customer redirected

Integration Steps

Step 1: Enable Deuna App Wallet in Admin

• Access your Deuna Admin Panel
• Navigate to Connections > Payment Methods
• Enable Deuna App Wallet
• Select preferred payment mode (Numeric Code or QR Code)
• Save configuration

See Deuna App Wallet Configuration for detailed setup instructions.

Step 2: Create an Order

• Use the Deuna API to create an order
• Receive order_token in response
• This token is required for all payment widget initializations

See Order Creation API Reference for details.

Step 3: Initialize Payment Widget

• Integrate Deuna SDK in your frontend
• Initialize Payment Widget with order token
• Configure deuna_wallet processor

See Deuna App Wallet via Widget for implementation details.

Step 4: Handle Payment Confirmation

• Listen for webhook callbacks on your backend
• Update order status based on confirmation
• Redirect customer to success/error page

See Deuna App Wallet via Widget - Callbacks for callback details.

Key Features

✅ Fast Checkout - Minimal friction with familiar Deuna App
✅ Two Payment Modes - Choose numeric code (3 min) or QR (15 min)
✅ Real-Time Confirmation - Webhook-based payment status updates
✅ Secure - Deuna App handles all sensitive data
✅ Mobile-First - Optimized for mobile payment experience
✅ Fallback Support - Polling ensures no missed confirmations

Environments

What's Next?

• Ready to implement? → See Deuna App Wallet via Widget
• Need to configure payment modes? → See Deuna App Wallet Configuration

Support

For integration questions or issues:

• Check Common Issues
• Review API Reference
• Contact Deuna support team

---

Last Updated: March 2026 Status: Production Ready