EdfaPay Logo

Theme Customization

Customize the SDK appearance to match your brand. Configure colors, typography, logos, and animations.

Overview

The SDK provides extensive customization options through the SdkTheme object. All theme settings should be configured before calling EdfaPayPlugin.initiate().

Loading...

Color Customization

setPrimaryColor

Sets the primary/accent color used for buttons, highlights, and key UI elements.

Loading...

setSecondaryColor

Sets the secondary color used for text on primary backgrounds, icons, and accents.

Loading...

Color Guidelines

PropertyUsed ForRecommendation
Primary ColorButtons, headers, progress indicatorsUse your brand's main color
Secondary ColorText/icons on primary backgroundsEnsure contrast ratio > 4.5:1

Typography

setFontScale

Adjusts the overall font size across all SDK screens. Useful for accessibility or display preferences.

Loading...
ValueEffectUse Case
0.8f20% smallerCompact displays
1.0fDefaultStandard usage
1.2f20% largerBetter readability
1.5f50% largerAccessibility, kiosk displays

Branding

setHeaderImage

Display your brand logo in the SDK header area.

Loading...

Logo Guidelines

  • Format: PNG with transparency (recommended) or JPEG
  • Dimensions: 200x60 pixels (or similar aspect ratio)
  • File size: Under 100KB for optimal performance
  • Background: Transparent works best with theme colors

setPoweredByImage

Customize the "Powered By" branding image.

Loading...

Restriction Notice

This feature may be restricted based on your partnership agreement. If restricted, a toast message will appear indicating the limitation.

Celebration Animations

Customize or disable the animations shown after successful operations.

Loading...

Global Animation Speed

Control all SDK animations globally:

Loading...
ValueEffect
0.5fHalf speed (slower, more dramatic)
1.0fNormal speed
1.5f1.5x faster
2.0fDouble speed
3.0fTriple speed (snappy feel)

Complete Examples

Standard Business App

Loading...

Accessibility-Focused

Loading...

Quick Checkout Kiosk

Loading...

Best Practices

  • 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 to prevent layout issues
  • Presentation Choice: Use DIALOG_BOTTOM_FILL for standard mobile UX