Deuna App Wallet Configuration

Overview

This guide covers the merchant-side configuration of Deuna App Wallet in the Deuna Admin Panel. Configuration is a one-time setup that determines which payment mode your customers will use.

Accessing Configuration

Step 1: Log In to Deuna Admin

1. Navigate to DEUNA's Admin
2. Enter your merchant credentials
3. Click Log In

Step 2: Navigate to Payment Methods

1. In the left sidebar, go to Connections
2. Click on Payment Methods
3. Look for Deuna App Wallet in the list

Initial Setup

Enabling Deuna App Wallet

If Deuna App Wallet is not yet enabled:

1. Find Deuna App Wallet in the Payment Methods list
2. Click Enable or Add
3. A configuration panel will open with a form to add the processor
4. Fill in all four required credential fields (see section below)
5. Select your preferred payment mode (see section below)
6. Click Save

The payment method is now active and will appear as an option for your customers at checkout.

Adding the Deuna App Wallet Processor

When you enable Deuna App Wallet, you must add the processor with credentials from your Deuna App Wallet account.

To add the processor:

1. In the Deuna App Wallet configuration panel
2. Click Add Processor or Configure Credentials
3. Fill in all four required fields:

Required Fields

Step-by-Step Form

Important:

• All four fields are required
• Your credentials come from your Deuna App Wallet business account
• Format selection here determines the payment mode for all orders
• After saving, credentials are encrypted and stored securely

Choosing Your Payment Format

When filling the processor form, you must select your payment format. This choice is made when adding credentials and determines how your customers will interact with the payment flow.

Format Selection Guide

Format 1: Numeric Code (CODIGO_6_DIGITOS, 3 Minutes)

Choose this if:

• Your customers primarily use desktop/tablet
• You want a quick transaction window
• Your checkout flow runs on multiple device types
• You prefer simplicity and minimal dependencies

How it works:

1. Customer sees a large 6-digit code
2. Code expires in exactly 3 minutes
3. Customer must open Deuna App and enter the code manually
4. After entering, customer confirms in the app
5. Payment confirmed via webhook

To select this format:

1. In the processor form
2. Under Format, select Numeric Code (CODIGO_6_DIGITOS)
3. Complete the form and click Save Processor

Verification:

• Once saved, you'll see a confirmation message
• All subsequent orders will use 6-digit numeric codes

Format 2: QR Code (15 Minutes)

Choose this if:

• Your customers are primarily mobile users
• You want a longer transaction window for flexibility
• You prefer a modern, one-tap experience
• QR scanning is common in your target market

How it works:

1. Customer sees a dynamic QR code
2. QR code is valid for exactly 15 minutes
3. Customer can either:
   • Scan with the Deuna App camera
   • Click to open the app directly
4. Payment confirmed via webhook

To select this format:

1. In the processor form
2. Under Format, select QR Code
3. Complete the form and click Save Processor

Verification:

• Once saved, you'll see a confirmation message
• All subsequent orders will use QR codes

Configuration Panel

Troubleshooting Configuration

Issue: Can't Find Deuna App Wallet in Payment Methods List

Solution:

• Refresh the page
• Check that you have "Payments" permission in your user role
• Contact Deuna support to ensure Deuna App Wallet is provisioned for your account

Issue: Processor Won't Save or Shows Error

Solution:

1. Verify all four credential fields are filled:
   • Public API Key (not empty)
   • Private API Key (not empty)
   • Point of Sale / CAJA (not empty, numeric string)
   • Format selected (QR or Numeric Code)
2. Check that credentials are correct from your Deuna App Wallet account
3. Test your credentials in the Deuna App Wallet dashboard first
4. Try again in a different browser
5. Contact Deuna support if issue persists

Issue: Customers Can't See Deuna App Wallet at Checkout

Verify:

1. Deuna App Wallet is Enabled (not Disabled)
2. Processor is properly configured (all four fields filled)
3. Customer's order is in USD currency
4. Customer is in Ecuador (or using Ecuador billing address)
5. Payment Widget includes deuna_wallet processor
6. Order token was generated successfully

If all verified:

• Contact Deuna support

Permissions & Access

Required Admin Roles

To configure Deuna App Wallet, your user account must have:

• Connections - Read/Write permission
• Payment Methods - Read/Write permission
• Webhooks - Read/Write permission (for webhook setup)

If you lack permissions:

1. Ask your account owner or admin
2. They can grant permissions in User Roles and Permissions section

Multi-Admin Setup

If multiple admins manage payments:

1. All configuration changes are visible to all admins
2. Any admin can change payment mode (not recommended without communication)
3. Enable audit logs to track changes:
   • Go to User Roles and Permissions
   • Enable Activity Log

Best Practices

Configuration

✅ Do:

• Test webhook connectivity after setup
• Choose payment mode based on your customer base
• Review refund limitations before enabling
• Document your mode choice for your team

❌ Don't:

• Disable Deuna App Wallet without notifying your team
• Frequently change payment modes without reason
• Share webhook URLs in unsecured channels
• Assume mode selection can be overridden per order (it can't)

Monitoring

✅ Do:

• Check payment metrics weekly
• Review webhook delivery logs regularly
• Monitor refund requests for trends
• Test webhook connectivity monthly

❌ Don't:

• Ignore webhook failures for extended periods
• Skip merchant onboarding testing
• Forget to update webhook URL if your backend changes