Theme Customization
Customize the SDK appearance to match your brand. Configure colors, typography, logos, and animations.
Quick Start
Configure the theme before calling initiate(). All methods are chainable.
Loading...Timing
All theme methods must be called BEFORE EdfaPayPlugin.initiate(). Changes made after initialization may not take effect.
Color Customization
Use setPrimaryColor and setSecondaryColor to match your brand. Ensure WCAG AA contrast ratio (4.5:1 minimum).
| Property | Used For | Recommendation |
|---|---|---|
| Primary Color | Buttons, headers, progress indicators | Use your brand's main color |
| Secondary Color | Text/icons on primary backgrounds | Ensure contrast ratio > 4.5:1 |
Loading...Typography
Adjust the global font size across all SDK screens with setFontScale.
| Value | Effect | Use Case |
|---|---|---|
| 0.8f | 20% smaller | Compact displays |
| 1.0f | Default | Standard usage |
| 1.2f | 20% larger | Better readability |
| 1.5f | 50% larger | Accessibility, kiosk displays |
Loading...Branding
Add your logo to the SDK header and customize the 'Powered By' branding.
Loading...Logo Guidelines
Format: PNG with transparency (recommended) or JPEG. Dimensions: 200x60px (or similar ratio). File size: Under 100KB.
Celebration Animations
Customize or disable the animations shown after successful terminal registration and purchase transactions. Pass a Base64-encoded Lottie JSON, or null to disable.
Loading...Global Animation Speed
Control all SDK animations globally via EdfaPayPlugin.animationSpeedX.
| Value | Effect |
|---|---|
| 0.5f | Half speed (slower, more dramatic) |
| 1.0f | Normal speed |
| 1.5f | 1.5x faster |
| 2.0f | Double speed |
| 3.0f | Triple speed (snappy feel) |
Complete Examples
Ready-made configurations for common use cases.
Standard Business App
Loading...Quick Checkout Kiosk
Loading...Best Practices
Follow these guidelines when configuring your SDK theme:
Configure Early
Always set theme before EdfaPayPlugin.initiate().
Test Color Contrast
Ensure primary/secondary have WCAG AA contrast (4.5:1 minimum).
Logo Optimization
Use appropriately sized images (200x60px, under 100KB) to prevent layout issues.
Presentation Choice
Use DIALOG_BOTTOM_FILL for standard mobile UX (default).
Security
Enable setShufflePinPad(true) for higher security requirements.
Environment-Specific Colors
Use different primary colors to visually distinguish sandbox vs production.
On this page
Downloads
Coming SoonSample apps, release bundles, and more content will be available here soon.