Quick Start
Get your mobile payment integration running in 4 simple steps
Platform Examples
Complete code examples for Android, iOS, React Native, and Flutter
Prerequisites
Before integrating Dodo Payments into your mobile app, ensure you have:- Dodo Payments Account: Active merchant account with API access
- API Credentials: API key and webhook secret key from your dashboard
- Mobile App Project: Android, iOS, React Native, or Flutter application
- Backend Server: To securely handle checkout session creation
Integration Workflow
The mobile integration follows a secure 4-step process where your backend handles API calls and your mobile app manages the user experience.1
Backend: Create Checkout Session
Checkout Session API Docs
Learn how to create a checkout session in your backend using Node.js, Python, and more. See complete examples and parameter references in the dedicated Checkout Sessions API documentation.
Security: Checkout sessions must be created on your backend server, never in the mobile app. This protects your API keys and ensures proper validation.
2
Mobile: Get Checkout URL
Your mobile app calls your backend to get the checkout URL:
- iOS (Swift)
- Android (Kotlin)
- React Native (JavaScript)
Security: Mobile apps only communicate with your backend, never directly with Dodo Payments API.
3
Mobile: Open Checkout in Browser
Open the checkout URL in a secure in-app browser for payment processing.
See platform-specific integration examples
View full code and setup instructions for Android, iOS, and Flutter mobile payments.
4
Backend: Handle Payment Completion
Process payment completion via webhooks and redirect URLs to confirm payment status.
Platform-Specific Integration
Choose your mobile platform below for complete implementation examples:Best Practices
- Security: Never store API keys in your app code. Use secure storage and SSL pinning.
- User Experience: Show loading indicators, handle errors gracefully, and provide clear messages.
- Testing: Use test cards, simulate network errors, and test on various devices.
Troubleshooting
Common Issues
- WebView not opening payment link: Ensure the payment link is valid and uses HTTPS.
- Callback not received: Check your return URL and webhook configuration.
- API key errors: Verify that your API key is correct and has the necessary permissions.
Additional Resources
For questions or support, contact support@dodopayments.com.