DEUNA App Wallet

Expand

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.

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