How to set up PayumBundle with Stripe in Symfony?

Configure the Stripe gateway in payum.yaml with your API keys, then use the Capture request as shown in the examples. Ensure token storage is set up to handle secure redirects during payment processing.

PayumBundle vs Omnipay for Symfony payments?

PayumBundle offers deeper Symfony integration and more operations like authorize and refund, while Omnipay focuses on simpler gateway abstraction. Choose PayumBundle for complex, multi-gateway workflows in Symfony apps.

Does PayumBundle support recurring payments or subscriptions?

PayumBundle handles operations like authorize and capture but does not include built-in subscription management. For recurring payments, you need to integrate with gateway-specific APIs or add custom logic on top.

How to handle payment webhooks with PayumBundle?

PayumBundle does not provide out-of-the-box webhook handling; you must create custom Symfony controllers to receive webhook notifications from gateways and update payment statuses using Payum's models.

Is PayumBundle compatible with Symfony 6 and PHP 8?

Yes, the bundle supports Symfony 4 and above, as noted in the README for Symfony 4+ configuration. Check the documentation for specific version requirements and updates.

How to test payments locally without real gateways?

Use the offline gateway included in PayumBundle, which simulates payment processes without external API calls. Configure it in payum.yaml and run test transactions as shown in the purchase example.

PayumBundle — Symfony Payment Processing Bundle

What is PayumBundle?

PayumBundle is a Symfony bundle that integrates the Payum payment processing library, enabling developers to handle online payments with support for 35+ gateways. It provides a structured way to configure payment gateways, process transactions, and manage payment states within Symfony applications. The bundle simplifies complex payment workflows while maintaining security and flexibility.

Target Audience

Symfony developers building eCommerce platforms, SaaS applications, or any web application requiring payment processing functionality. It's particularly useful for teams needing multi-gateway support and production-ready payment integration.

Value Proposition

Developers choose PayumBundle for its extensive gateway support, seamless Symfony integration, and proven reliability in production environments like Sylius. It eliminates the need to write custom payment integration code for each gateway while providing secure, maintainable payment processing infrastructure.

Payum offers everything you need to work with payments. From simplest use cases to very advanced ones.

Use Cases

Best For

Integrating multiple payment gateways in Symfony applications
Building eCommerce platforms with flexible payment options
Handling subscription billing and recurring payments
Processing one-time payments for digital goods or services
Implementing secure payment capture endpoints
Managing payment status tracking and transaction history

Not Ideal For

Projects not using the Symfony framework (e.g., Laravel or standalone PHP applications)
Applications with only one simple payment gateway and no need for abstraction layers
Teams wanting a fully managed payment API with minimal server-side configuration and no custom storage setup

Pros & Cons

Pros

Extensive Gateway Support

Supports over 35 payment gateways including PayPal and Stripe, as documented in the supported gateways list, providing flexibility for diverse payment needs.

Seamless Symfony Integration

Integrates directly into Symfony with configuration files and services, simplifying setup and leveraging Symfony's dependency injection, as shown in the YAML examples.

Built-in Secure Controllers

Includes secure capture controllers for handling payment endpoints, reducing security risks by managing redirects and token storage internally.

Flexible Storage Options

Allows integration with various storage backends for payment and token data, such as filesystem storage, enabling persistence without locking into a specific database.

Production-Proven Reliability

Used as the foundation for the Sylius eCommerce platform, indicating real-world testing and stability in high-traffic environments.

Cons

Configuration Overhead

Requires manual YAML configuration for each gateway and storage, which can be verbose and error-prone, especially for beginners or teams with many gateways.

Symfony Lock-in

Tightly coupled with Symfony framework, making it unsuitable for projects using other PHP frameworks or microservices without significant adaptation.

Limited Webhook Handling

Does not provide built-in support for payment gateway webhooks; developers must implement custom endpoints to process asynchronous notifications, adding complexity.

Frequently Asked Questions

What is PayumBundle?

Target Audience

Value Proposition

Use Cases

Best For

Integrating multiple payment gateways in Symfony applications
Building eCommerce platforms with flexible payment options
Handling subscription billing and recurring payments
Processing one-time payments for digital goods or services
Implementing secure payment capture endpoints
Managing payment status tracking and transaction history

Not Ideal For

Projects not using the Symfony framework (e.g., Laravel or standalone PHP applications)
Applications with only one simple payment gateway and no need for abstraction layers
Teams wanting a fully managed payment API with minimal server-side configuration and no custom storage setup

Pros & Cons

Pros

Extensive Gateway Support

Supports over 35 payment gateways including PayPal and Stripe, as documented in the supported gateways list, providing flexibility for diverse payment needs.

Seamless Symfony Integration

Integrates directly into Symfony with configuration files and services, simplifying setup and leveraging Symfony's dependency injection, as shown in the YAML examples.

Built-in Secure Controllers

Includes secure capture controllers for handling payment endpoints, reducing security risks by managing redirects and token storage internally.

Flexible Storage Options

Allows integration with various storage backends for payment and token data, such as filesystem storage, enabling persistence without locking into a specific database.

Production-Proven Reliability

Used as the foundation for the Sylius eCommerce platform, indicating real-world testing and stability in high-traffic environments.

Cons

Configuration Overhead

Requires manual YAML configuration for each gateway and storage, which can be verbose and error-prone, especially for beginners or teams with many gateways.

Symfony Lock-in

Tightly coupled with Symfony framework, making it unsuitable for projects using other PHP frameworks or microservices without significant adaptation.

Limited Webhook Handling

Does not provide built-in support for payment gateway webhooks; developers must implement custom endpoints to process asynchronous notifications, adding complexity.

Frequently Asked Questions

PayumBundle

What is PayumBundle?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

PayumBundle

What is PayumBundle?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?