| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 1351 |
| Technical Name |
d_pos_adyen_tap_to_pay |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
| Versions | 17.0 18.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 1351 |
| Technical Name |
d_pos_adyen_tap_to_pay |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
| Versions | 17.0 18.0 |
POS Adyen Tap to Pay
Contactless Payment Solution for Odoo POS
This module enables contactless payments with Adyen Tap to Pay in your Odoo Point of Sale system. Accept payments directly through mobile devices with secure NFC technology, eliminating the need for additional hardware.
Learn more about Adyen Tap to Pay at: https://www.adyen.com/devices/tap-to-pay-on-android
Key Features
- Contactless payment acceptance via mobile NFC
- Seamless integration with Adyen payment platform
- Real-time transaction processing
- Multi-company support
- Mobile device compatibility
- PCI DSS compliance through Adyen
- Automatic boarding process
- Advanced error handling and retry mechanisms
Usage Guide
Please visit the Documentation tab next to this tab for detailed usage instructions
Special Offer
50% Discount Available!
For customers in regions where Adyen provides full support and test cards are available
Get this powerful payment solution at a special introductory price!
TECHNICAL SUPPORT
Contact for support: duongodooapps@gmail.com
Website: https://duong-odoo-apps.odoo.com
POS Adyen Tap to Pay
Transform your Point of Sale with Adyen's innovative Tap to Pay technology! Accept contactless payments directly through mobile devices with secure NFC technology.
Overview
The POS Adyen Tap to Pay module enables contactless payment acceptance in your Odoo Point of Sale system through Adyen's Tap to Pay technology. This solution allows merchants to accept contactless card and mobile payments using compatible Android mobile devices with NFC capability.
Key Features: - Contactless payment acceptance via mobile NFC - Seamless integration with Adyen payment platform - Real-time transaction processing - Multi-company support - PCI DSS compliance through Adyen
Prerequisites
Before using this module, ensure you follow this https://docs.adyen.com/point-of-sale/mobile-android/build/payments-app/?tab=full-response_1#requirements:
- Adyen Merchant Account: Active Adyen merchant account with Tap to Pay enabled
- Compatible Device: Android mobile device with NFC capability
- Regional Support: Your region must be supported by Adyen Tap to Pay
- Internet Connection: Stable internet connection for real-time processing
- Odoo Module: pos_adyen module installed and configured
Supported Regions: Check if your region is supported at: https://docs.adyen.com/point-of-sale/ipp-mobile/#supported-countriesregions
Installation
- Install the module from Odoo Apps
- Ensure pos_adyen module is installed and configured
- Restart your Odoo server
Configuration Guide
IMPORTANT: All the setting and making payment using this module require you to operate on your android phone
Step 1: Configure POS Payment Method in Odoo
- Navigate to Payment Methods: - Go to Point of Sale → Configuration → Payment Methods - Select your existing Adyen payment method or create a new one
- Configure Adyen Settings: - Name: Enter a descriptive name (e.g., "Adyen Tap to Pay") - Integration: Choose terminal - Integrate with: Select "Adyen" - Enable Tap to Pay: Enable this option - Adyen API key: Enter your Adyen API key (from Adyen Customer Area) - Adyen Merchant ID: Enter this manually or leave it empty to automatically fill after save - Key Identifier: This will be auto-generated by Odoo after saving - Passphrase: This will be auto-generated by Odoo after saving - Key Version: This will be auto-generated by Odoo after saving - Adyen Test Mode: Enable this option first for testing purpose
Save the Configuration
After saving, Odoo will automatically generate the Key Identifier, Passphrase, and Key Version values.
Step 2: Configure Adyen Customer Area
Now you need to copy the generated keys from Odoo to your Adyen Customer Area:
- Login to Adyen Customer Area: - Go to https://ca-test.adyen.com/ (for test) or https://ca-live.adyen.com/ (for live) - Login with your Adyen merchant account credentials
- Navigate to Terminal Settings: - In the left sidebar, click on "In-person payments" - Select "Terminal Settings"
- Go to Integrations: - Click on the "Integrations" tab - Switch to "Decrypt" mode (very important!) - Scroll down to find the integration settings
- Enter the Keys from Odoo: - Key Identifier: Copy this value from your Odoo payment method configuration - Passphrase: Copy this value from your Odoo payment method configuration - Key Version: Copy this value from your Odoo payment method configuration
- Save the Configuration in Adyen
Important Notes: - The Key Identifier, Passphrase, and Key Version are generated by Odoo and must be copied TO Adyen - Make sure you're in "Decrypt" mode when entering these values in Adyen Customer Area - Keep these credentials secure and don't share them - Use test environment for testing and live environment for production
Step 3: Complete Boarding Process
- Mobile Device Setup: - Install the Adyen Tap to Pay test app on your Android device - Ensure NFC is enabled on the device
- Access Boarding Function: - In the payment method configuration, you'll see boarding options - Click the "Start Boarding Process" button
- Complete Boarding: - The system will automatically notify whether the boarding process on your phone success or not
Step 4: Add Payment Method to POS
- Configure POS Settings: - Go to Point of Sale → Configuration - Select your POS configuration
- Add Payment Method: - In the Payment Methods section, Select your Adyen tab to pay - Select the Adyen Tap to Pay payment method you configured - Save the POS configuration
- Update POS Session: - Close any active POS sessions - Start a new POS session to load the new payment method
Step 5: Using Adyen Tap to Pay in POS
Processing Payments
- Create Order: - Add products to your POS order as usual - Click Payment when ready to process payment
- Select Payment Method: - Choose Adyen Tap to Pay from the payment methods - Enter the payment amount
- Initiate Payment: - Click Validate to start the payment process - The system will open the Adyen Tap to Pay app on your mobile device
- Accept Payment: - On your mobile device, the Adyen app will display payment details - Ask the customer to tap their contactless card or mobile device - The device will beep and show confirmation when payment is successful
- Complete Transaction: - The POS will automatically receive payment confirmation - Complete the order and print receipt if needed
Mobile Device Payment Process
What happens on your mobile device:
- Payment Request: The Adyen app opens automatically
- Payment Details: Shows the amount and transaction details
- Ready to Accept: Device is ready to accept contactless payments
- Customer Interaction: Customer taps their card or mobile device
- Processing: Transaction is processed in real-time
- Confirmation: Success or failure message is displayed
- Return to POS: Payment status is sent back to Odoo POS
Testing Your Integration
Before going live, thoroughly test your integration:
- Test Environment Setup: - Use Adyen's test environment - Configure test API credentials - Ensure keys are properly configured in both Odoo and Adyen Customer Area
- Test Scenarios: - Successful contactless payments - Failed payment scenarios - Network connectivity issues - Different card types and mobile wallets
- Verify Integration: - Check payment confirmations in Odoo - Verify transaction details in Adyen Customer Area - Test refund functionality - Validate multi-company scenarios (if applicable)
Going Live with Adyen
After successful testing, you need to contact Adyen to go live:
Step 1: Contact Adyen for Go-Live
- Adyen Contact Process: - Visit: https://www.adyen.com/devices/tap-to-pay-on-android - Fill out the contact form to express interest in Tap to Pay on Android - Provide your business details and requirements
- Information Required: - Business information and merchant account details - Expected transaction volumes - Integration testing results - Go-live timeline
- Adyen Review Process: - Adyen will review your integration - They may request additional testing or documentation - Approval process for live environment access
Step 2: Production Configuration
Once approved by Adyen:
- Update Environment Settings in Odoo: - Change environment from "Test" to "Live" in payment method configuration - Update API credentials with production keys - The Key Identifier, Passphrase, and Key Version will be regenerated for production
- Update Adyen Customer Area: - Switch to live Adyen Customer Area (https://ca-live.adyen.com/) - Copy the new production keys from Odoo to Adyen Customer Area - Follow the same process as in Step 2 above
- Production Boarding: - Re-board your mobile devices with production credentials - Test with small live transactions - Monitor initial transactions closely
- Go-Live Checklist: - ✓ All test scenarios passed - ✓ Adyen approval received - ✓ Production credentials configured in Odoo - ✓ Production keys copied to live Adyen Customer Area - ✓ Devices boarded in production - ✓ Staff trained on the new system - ✓ Backup payment methods available
Important Go-Live Notes
Adyen Requirements: - Adyen Tap to Pay is currently available in: US, Europe, UAE, Singapore, Hong Kong, Malaysia, Australia and New Zealand - Businesses must provide their own Android devices - Devices must meet Adyen's technical requirements
Key Management: - Keys are generated by Odoo and must be copied TO Adyen Customer Area - Ensure you're in "Decrypt" mode when entering keys in Adyen Customer Area - Use separate keys for test and live environments
Timeline Considerations: - Allow 2-4 weeks for Adyen's review and approval process - Plan go-live during low-traffic periods - Have technical support available during initial rollout
Troubleshooting
Common Issues
Payment Method Not Appearing: - Verify the payment method is added to POS configuration - Restart POS session - Check if pos_adyen module is installed
Boarding Failed: - Ensure mobile device has NFC enabled - Check internet connection - Verify API key is correct in Odoo - Ensure the generated keys (Key Identifier, Passphrase, Key Version) are properly copied to Adyen Customer Area - Verify you're in "Decrypt" mode when entering keys in Adyen - Try boarding process again
Payment Not Processing: - Check if mobile device is properly boarded - Verify Adyen merchant account is active - Ensure customer's card supports contactless payments - Verify keys are properly synchronized between Odoo and Adyen
Mobile App Issues: - Update Adyen Tap to Pay app to latest version - Check app permissions - Restart the app
Key Synchronization Issues: - Verify the keys generated in Odoo match those entered in Adyen Customer Area - Ensure you're using the correct environment (test vs live) - Check that you're in "Decrypt" mode when viewing/entering keys in Adyen - Contact support if keys don't seem to be working
Error Messages
"ServiceID Value too long": - This has been fixed in the latest version - Update the module if you encounter this error
"Device not boarded": - Complete the boarding process again - Ensure you're using the correct boarding URL - Verify keys are properly configured in both systems
"Payment failed": - Check error details in POS - Verify card is contactless-enabled - Try with a different payment card
"Authentication failed": - Check that the keys generated in Odoo are properly copied to Adyen Customer Area - Ensure you're using the correct environment credentials - Verify you entered keys in "Decrypt" mode in Adyen
Regional Limitations
Important Notice for Vietnam Users: Due to regional limitations, Adyen doesn't provide test cards for Vietnam. We cannot fully test the module in Vietnam, but we offer comprehensive support for regions where Adyen provides full testing capabilities.
Supported Regions: Check the complete list of supported countries and regions at: https://docs.adyen.com/point-of-sale/ipp-mobile/#supported-countriesregions
Available Regions (as per Adyen): - Asia Pacific: Hong Kong, Malaysia, Singapore, Australia, New Zealand - Europe: Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Gibraltar, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland, United Kingdom - Middle East: United Arab Emirates - North America: United States
Free Demo Available: If you're in a supported region and would like to see the module in action, we offer free demo sessions. Contact us at: duongodooapps@gmail.com
Security & Compliance
PCI DSS Compliance: - All transactions are processed through Adyen's PCI DSS Level 1 compliant platform - No sensitive payment data is stored locally - End-to-end encryption for all transactions
Data Protection: - Secure token handling - Transaction data is encrypted - Compliance with regional data protection regulations - Keep all generated keys secure and confidential
Technical Requirements
Device Requirements: - Android mobile device with NFC capability - Minimum Android version as specified by Adyen - Stable internet connection (WiFi or mobile data)
Odoo Requirements: - Odoo 18 Community or Enterprise Edition - pos_adyen module installed and configured - Active Adyen merchant account
Support & Contact
Technical Support: - Email: duongodooapps@gmail.com - Website: https://duong-odoo-apps.odoo.com
Free Demo: For customers in supported regions, we offer free demonstration sessions to show the module functionality before purchase.
Adyen Documentation: - Adyen Tap to Pay: https://docs.adyen.com/point-of-sale/mobile-android/build/payments-app/?tab=full-response_1#requirements - Supported Regions: https://docs.adyen.com/point-of-sale/ipp-mobile/#supported-countriesregions - Contact Adyen: https://www.adyen.com/devices/tap-to-pay-on-android
Important Note: This module requires an active Adyen merchant account and is subject to regional availability. Please verify your region is supported before purchasing.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module