Deuna (Banco Pichincha) configuration

OverviewAsk Athia about this#

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

Accessing ConfigurationAsk Athia about this#

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 Wallet in the list. This Admin identifier refers to the Banco Pichincha-backed Deuna wallet.

Initial SetupAsk Athia about this#

Enabling Deuna (Banco Pichincha)

If Deuna (Banco Pichincha) is not yet enabled:

1. Find Deuna Wallet in the Payment Methods list. This is the Admin label for the Deuna (Banco Pichincha) connection.
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 (Banco Pichincha) Processor

When you enable Deuna (Banco Pichincha), you must add the processor with credentials from your Deuna (Banco Pichincha) account.

To add the processor:

1. In the Deuna (Banco Pichincha) configuration panel
2. Click Add Processor or Configure Credentials
3. Fill in all four required fields:

Required Fields

Step-by-Step Form

Expand

Important:

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

Choosing Your Payment FormatAsk Athia about this#

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. DEUNA processes the final payment state asynchronously

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. DEUNA processes the final payment state asynchronously

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 PanelAsk Athia about this#

Troubleshooting Configuration

Issue: Can't Find Deuna 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 (Banco Pichincha) 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 (Banco Pichincha) account
3. Test your credentials in the Deuna (Banco Pichincha) dashboard first
4. Try again in a different browser
5. Contact DEUNA support if issue persists

Issue: Customers Can't See Deuna (Banco Pichincha) at Checkout

Verify:

1. Deuna Wallet is Enabled (not Disabled) in DEUNA Admin
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 & AccessAsk Athia about this#

Required Admin Roles

To configure Deuna (Banco Pichincha), your user account must have:

• Connections - Read/Write permission
• Payment Methods - Read/Write permission

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 PracticesAsk Athia about this#

Configuration

✅ Do:

• Test asynchronous payment completion 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 (Banco Pichincha) without notifying your team
• Frequently change payment modes without reason
• Assume mode selection can be overridden per order (it can't)

Monitoring

✅ Do:

• Check payment metrics weekly
• Review unresolved payment states regularly
• Monitor refund requests for trends
• Test asynchronous payment completion regularly

❌ Don't:

• Ignore unresolved payment states for extended periods
• Skip merchant onboarding testing