Deuna (Banco Pichincha)

Expand

Getting Started with Deuna (Banco Pichincha)Ask Athia about this#

Deuna (Banco Pichincha) is a digital wallet payment method available in Ecuador. The customer pays in the Deuna app, while DEUNA orchestrates the payment.

How It WorksAsk Athia about this#

Deuna (Banco Pichincha) 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
• DEUNA processes the final provider state asynchronously

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
• DEUNA processes the final provider state asynchronously

Both modes use DEUNA's asynchronous payment-status processing with bounded status retrieval for reconciliation.

RequirementsAsk Athia about this#

To successfully integrate Deuna (Banco Pichincha), 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)

Configuration Requirements

• Deuna (Banco Pichincha) 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 & CurrenciesAsk Athia about this#

Payment Flow OverviewAsk Athia about this#

1. Customer initiates checkout
   ↓
2. Selects "Pay with Deuna (Banco Pichincha)"
   ↓
3. DEUNA generates the payment request (code or QR)
   ↓
4. Customer opens Deuna app & confirms payment
   ↓
5. DEUNA processes the provider status update
   ↓
6. Order marked as paid, customer redirected

Integration StepsAsk Athia about this#

Step 1: Enable Deuna (Banco Pichincha) in Admin

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

See Deuna (Banco Pichincha) 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 (Banco Pichincha) via Payment Widget for implementation details.

Step 4: Handle Payment Confirmation

• Retrieve the original order from your backend
• Update the merchant order from the final DEUNA payment state
• Redirect customer to success/error page

See Deuna (Banco Pichincha) via Payment Widget - Callbacks for callback details.

Key FeaturesAsk Athia about this#

• ✅ Fast Checkout - Minimal friction with familiar Deuna app
• ✅ Two Payment Modes - Choose numeric code (3 min) or QR (15 min)
• ✅ Asynchronous Confirmation - Provider status updates processed by DEUNA
• ✅ Secure - Deuna app handles all sensitive data
• ✅ Mobile-First - Optimized for mobile payment experience
• ✅ Fallback Support - Polling ensures no missed confirmations

EnvironmentsAsk Athia about this#

What's Next?Ask Athia about this#

• Ready to implement? → See Deuna (Banco Pichincha) via Payment Widget
• Need to configure payment modes? → See Deuna (Banco Pichincha) Configuration

SupportAsk Athia about this#

For integration questions or issues:

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

Last Updated: March 2026 Status: Production Ready