Download the PHP package payzum/sylius-payzum-plugin without Composer
On this page you can find all versions of the php package payzum/sylius-payzum-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download payzum/sylius-payzum-plugin
More information about payzum/sylius-payzum-plugin
Files in payzum/sylius-payzum-plugin
Package sylius-payzum-plugin
Short Description Accept crypto and stablecoin payments (USDC, USDT and more) in Sylius through Payzum — non-custodial
License MIT
Homepage https://payzum.com
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package sylius-payzum-plugin
Payzum plugin for Sylius
Accept crypto and stablecoin payments (USDC, USDT and more, multi-chain) in Sylius through Payzum — non-custodial: funds settle directly to your own wallet, Payzum never takes custody.
Built for Sylius 2.x on the PaymentRequest flow (not Payum), following the structure of the official StripePlugin.
How it works
- The customer picks Payzum at checkout and is redirected to a hosted checkout page, where they choose the asset and chain and send the payment. No wallet or card data touches your server.
- Crypto confirmation is asynchronous, so the payment is completed from
Payzum's signed server-to-server notification, never from the browser
return. When the buyer comes back, the pay page shows the real state — a
payment that is still confirming stays in
processing. - Every notification is verified with HMAC-SHA-512 over the raw request bytes (with a replay window) before a single field of it is read, and the invoice amount and currency are re-checked against the payment before it is completed. Redelivered notifications are a no-op, so an order is never fulfilled twice.
Installation
Register the bundle in config/bundles.php:
Then create a payment method in the admin panel (Configuration → Payment methods → Create), choose the Payzum (crypto & stablecoins) gateway and fill in:
| Setting | Meaning |
|---|---|
| API key | From your Payzum merchant dashboard |
| Webhook secret | Verifies incoming payment notifications; shown once, separately from the API key |
| Pay currency | Optional. Pin one asset, e.g. usdc; empty lets the buyer choose |
| Network | Optional. Pin one chain for that asset, e.g. polygon |
| Sandbox mode | Use the Payzum staging environment |
The notification endpoint is Sylius' own
sylius_payment_method_notify route (/payment-methods/{code}); the plugin
sends it to Payzum with every invoice, so there is nothing to configure in the
dashboard.
Architecture
The Payzum-specific code is kept out of the Sylius layer, so the API client, signature verification and status mapping can be read and tested on their own:
Two design points worth knowing:
- The payment request hash travels as the Payzum
order_id, so a verified notification is matched to its payment without trusting anything else in the payload — and each delivery is handled as a fresh payment request, which is what keeps the gateway's retries working after the order is paid. - Amounts are converted with exact string arithmetic (never through a float) and the currency's own number of decimals, so zero-decimal currencies (JPY) and three-decimal ones (KWD) are correct too.
Tests
License
MIT. The payzum/payzum-php
SDK it builds on is MIT as well and has no runtime dependencies.
