Viva.com Payment for POS
Integrate Viva.com payment gateway into Odoo POS. Accept credit cards, debit cards, and e-wallets quickly and securely.
Overview
Viva.com Payment module integrates Viva.com payment gateway into Odoo POS, allowing businesses to accept card and e-wallet payments directly at point of sale.
Process payments securely and quickly with full support for international cards and popular payment methods in Europe.
Key Features
Key points
• Credit/debit card payment - Accept Visa, Mastercard, American Express, Maestro
• E-wallet payment - Support Apple Pay, Google Pay, Samsung Pay
• Real-time payment processing - Instant payment confirmation
• Auto refund - Process refunds directly from POS
• Contactless payment - Support NFC and contactless payment
• PCI DSS security - Comply with international payment security standards
• Transaction reporting - Track all card payment transactions
• Auto reconciliation - Automatically reconcile transactions with bank statements
Target Users
Key points
• Restaurants - Accept card payments for dining bills
• Retail stores - Process card payments for shopping
• Hotels - Payment for accommodation and amenities
• Finance managers - Track revenue from card payments
How to Use
Steps
1. Register merchant account with Viva.com
2. Get API credentials from Viva.com dashboard
3. Configure Viva.com in Odoo: Settings → POS → Payment Methods
4. Create new payment method, select "Viva.com"
5. Enter Merchant ID, API Key, Source Code from Viva.com
6. Connect card reader device (if any) or use payment terminal
7. Add Viva.com payment method to POS
8. Open POS session to start accepting card payments
9. When customer pays, select "Viva.com" in payment screen
10. Customer swipes card or taps e-wallet on reader
11. System processes and confirms payment automatically
Scenario 1: Credit card payment at restaurant
Customer finishes meal, bill is 1,500,000đ. Chooses to pay with Visa card.
Staff selects "Viva.com" in POS, customer swipes card. Payment confirmed in 2 seconds, prints receipt and card slip.
Scenario 2: Apple Pay contactless payment
Customer shops at store, total 850,000đ. Wants to pay with Apple Pay.
Staff selects "Viva.com", customer taps iPhone on NFC reader. Payment completes instantly.
Scenario 3: Process customer refund
Customer returns product purchased with card. Staff creates return order in POS.
Selects refund via Viva.com, system automatically refunds to customer card. Customer receives refund notification from bank.
Scenario 4: Payment declined
Customer swipes card but payment is declined (over limit or expired card).
POS displays "Payment declined" message, staff suggests customer use alternative payment method.
Scenario 5: End of day reconciliation
End of day, manager closes POS session. System automatically reconciles all Viva.com transactions.
Report shows: 45 card transactions, total 67,500,000đ, 2 refunds 3,200,000đ, net 64,300,000đ.
Important Terminology
Key points
• Payment Gateway - Service that processes online card payments
• Merchant ID - Unique identifier for business on Viva.com
• API Key - Security key to connect POS with Viva.com
• Source Code - Transaction source code to distinguish point of sale
• Payment Terminal - Card reader device connected to POS
• Contactless Payment - NFC contactless payment
• PCI DSS - Payment Card Industry Data Security Standard
• Authorization - Transaction authentication with card issuing bank
• Settlement - Process of transferring funds from bank to merchant account
Tips for Effective Use
Key points
• Check internet connection before opening POS session
• Ensure card reader is fully charged and connected
• Guide customers on using contactless payment
• Always print card receipt for customer to keep
• Check daily reconciliation to detect discrepancies
• Update card reader software regularly
• Train staff to handle declined payment situations
• Store card transaction receipts per legal requirements
System Requirements
Key points
• POS module installed in Odoo
• Viva.com merchant account activated
• Stable internet connection for payment processing
• Compatible card reader (optional) or payment terminal
• Printer for card receipt printing
• SSL certificate for secure connection
Troubleshooting: Cannot connect to Viva.com
Key points
• Check internet connection
• Verify API credentials entered correctly
• Check Viva.com account status (is it locked)
• View error logs: Settings → Technical → Logging → filter "viva"
• Try test connection in payment method configuration
Troubleshooting: Payment declined
Key points
• Check card is not expired
• Verify card has sufficient limit
• Suggest customer contact issuing bank
• Try alternative payment method
• Check error code in logs for specific reason
Troubleshooting: Card reader not working
Key points
• Check card reader battery
• Ensure reader is connected via Bluetooth/USB to POS
• Restart card reader
• Check card reader driver is installed
• Try alternative card reader if available
Troubleshooting: Refund failed
Key points
• Check original transaction is settled
• Ensure refund amount does not exceed original amount
• Verify merchant account has sufficient balance
• Try manual refund in Viva.com dashboard
• Contact Viva.com support if issue persists
Troubleshooting: Reconciliation mismatch
Key points
• Check all transactions are synced
• Review refund transactions
• Compare with report from Viva.com dashboard
• Check pending unsettled transactions
• Contact administrator to check detailed logs
Frequently Asked Questions
Key points
• What are Viva.com transaction fees? - Depends on merchant contract, typically 1.5-3% per transaction
• How long until funds reach account? - Usually 1-3 business days after settlement
• Is there a transaction amount limit? - Yes, depends on merchant configuration and card type
• Can I do partial refunds? - Yes, supports partial or full refunds
• Does Viva.com support domestic cards? - Depends on country, contact Viva.com for details
• How to handle chargebacks? - Monitor notifications from Viva.com and provide transaction proof
Business Benefits
Key points
• Increase revenue by 35% by accepting card payments
• Reduce cash risk and cash management costs
• Speed up payment process, reduce customer wait time
• Improve customer experience with multiple payment methods
• Auto reconciliation saves accounting time
• Detailed reports help analyze customer payment behavior