Embedded Components
We strongly recommend implementing the Pay Hub for customer payment management. This approach ensures customers automatically receive new features and functionality as they are released, without requiring additional development or integration updates from your team.
As an alternative to directing customers to the Pay Hub, you can integrate Stripe's embedded components directly into your product interface to provide seamless payment management capabilities within your existing application.
Overview
Embedded components allow you to maintain complete control over the user experience while leveraging Stripe's secure, pre-built payment management functionality. This approach provides flexibility in design and workflow integration while ensuring compliance with security and regulatory requirements.
Implementation Requirements
Role-Based Access Control
Your application must implement appropriate role-based access controls to manage user permissions for different component actions. This ensures users only access functionality appropriate to their organizational role and responsibilities.
Consider implementing permission levels such as:
- View-only access for basic transaction visibility
- Processing permissions for refunds and dispute management
- Administrative access for comprehensive payment management
Security Considerations
All embedded components maintain PCI DSS compliance through Stripe's secure infrastructure while allowing customization of the user interface and workflow integration within your product.
Approved Components
Due to risk management and compliance requirements, the following Stripe embedded components have been approved for use within Group Payments integrations:
| Component | Description | Primary Use Case |
|---|---|---|
| Payment Listing | Comprehensive payment list with export, refund, and dispute management capabilities | Transaction overview and bulk operations |
| Payment Details | Detailed transaction view with refund processing and dispute management tools | Individual payment management and customer service |
| Disputes List | Filterable dispute overview with comprehensive management capabilities | Chargeback and dispute resolution workflows |
| Payment Disputes | Payment-specific dispute management and resolution tools | Transaction-level dispute handling |
| Payouts Dashboard | Payout and balance information with manual payout capabilities | Settlement management and cash flow monitoring |
| Payouts List | Filterable payout history with detailed settlement information | Financial reconciliation and reporting |
| Notification Banner | Risk intervention alerts and onboarding requirement notifications | Compliance and account status management |
Technical Integration
For detailed implementation guidance, API specifications, and code examples, refer to Stripe's embedded components documentation.
Component Approval Process
Additional Stripe embedded components may be available but require approval through Group Payments' risk and compliance review process before implementation. Contact your integration support team if your use case requires components not listed above.
Benefits of Embedded Components
Seamless User Experience: Keep users within your application while providing comprehensive payment management
Customizable Interface: Maintain brand consistency and integrate with your existing design system
Flexible Workflows: Adapt payment management processes to match your specific business requirements
Secure Implementation: Leverage Stripe's security infrastructure while maintaining UI control
Next Steps
Ready to implement embedded components? Work with your development team to plan role-based access controls and component integration that aligns with your user experience goals and security requirements.