Presentation Modes
Configure how SDK screens are displayed - dialogs, full screen, position, size, and behavior.
Overview
The Presentation API controls how SDK payment screens appear on the device. Choose from fullscreen, centered dialogs, or positioned bottom/top sheets, then fine-tune behavior, animations, visual style, and sizing with chainable methods.
10 Presentation Types
Fullscreen, center, top, bottom, and corner positions
Behavior Control
Dismiss on touch, back press, and animation toggles
Visual Styling
Corner radius, dim amount, and background settings
Sizing Options
sizePercent and margin configuration
Presentation Types
The Presentation enum controls the visual presentation of SDK screens. The default is DIALOG_BOTTOM_FILL.
| Presentation | Position | Description |
|---|---|---|
| FULLSCREEN | Full screen | Takes entire screen |
| DIALOG_CENTER | Center | Centered modal dialog |
| DIALOG_TOP_FILL | Top | Top-aligned, full width |
| DIALOG_TOP_START | Top-Left | Top-left corner |
| DIALOG_TOP_END | Top-Right | Top-right corner |
| DIALOG_TOP_CENTER | Top-Center | Top, horizontally centered |
| DIALOG_BOTTOM_FILL | Bottom | Default — Bottom sheet, full width |
| DIALOG_BOTTOM_START | Bottom-Left | Bottom-left corner |
| DIALOG_BOTTOM_END | Bottom-Right | Bottom-right corner |
| DIALOG_BOTTOM_CENTER | Bottom-Center | Bottom, horizontally centered |
Behavior Methods
Control dismissal behavior and entry/exit animations when the dialog is active.
Loading...Visual Methods
Set background dimming and corner radius.
Loading...Sizing Methods
Control dialog margins and height as a percentage of screen height.
| sizePercent Value | Screen Coverage |
|---|---|
| 0.5f | 50% of screen |
| 0.75f | 75% of screen |
| 0.85f | 85% (recommended) |
| 1.0f | 100% (full height) |
Loading...Note
For DIALOG_BOTTOM_FILL, DIALOG_TOP_FILL, and FULLSCREEN, sizePercent is always forced to 1.0f.
Feature Methods
Configure purchase secondary actions and PIN pad security.
| Action | Description |
|---|---|
| PurchaseSecondaryAction.NONE | No secondary button |
| PurchaseSecondaryAction.REVERSE | Show 'Reverse' button |
| PurchaseSecondaryAction.REFUND | Show 'Refund' button |
Loading...FlowType Requirement
setPurchaseSecondaryAction only works with FlowType.DETAIL. It has no effect with IMMEDIATE or STATUS.
Complete Examples
Ready-made presentation configurations for common scenarios.
Loading...On this page
Downloads
Coming SoonSample apps, release bundles, and more content will be available here soon.