PHPackages                             webburza/payum-setefi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. webburza/payum-setefi

ActiveProject[Payment Processing](/categories/payments)

webburza/payum-setefi
=====================

Setefi Payum gateway

0.1.4(8y ago)17.3k1MITPHP

Since Dec 23Pushed 8y ago3 watchersCompare

[ Source](https://github.com/webburza/payum-setefi)[ Packagist](https://packagist.org/packages/webburza/payum-setefi)[ Docs](https://github.com/webburza/payum-setefi)[ RSS](/packages/webburza-payum-setefi/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (3)Versions (6)Used By (0)

Setefi Payum gateway
====================

[](#setefi-payum-gateway)

A [Payum](https://payum.forma-pro.com/) gateway for [Setefi](http://www.setefi.it/) payment processor.

**Note:** all [user IDs, passwords and secrets listed are documented by Setefi](https://www.servizi.monetaonline.it/documenti/monetaweb/MonetaWeb%202.0%20-%20Technical%20Documentation.pdf) *(section "TEST ENVIRONMENT CREDENTIALS"*) and shared with all other Setefi sandbox users, they're NOT a secret.

Sylius Integration
------------------

[](#sylius-integration)

```
# app/config/config.yml
parameters:
    # NOTE:
    # these are documented by Setefi and shared among all sandbox users, they're NOT a secret
    setefi.id: "99999999"
    setefi.password: "99999999"
    setefi.sandbox: true # false in config_prod.yml

payum:
    gateways:
        setefi:
            factory: "setefi"
            payum.http_client: "@sylius.payum.http_client"
            terminal_id: "%setefi.id%"
            terminal_password: "%setefi.password%"
            sandbox: "%setefi.sandbox%"

sylius_payment:
    gateways:
        setefi: Setefi
```

After having done this, enable the payment method in the Sylius admin interface.

*(**Note:** Any testing of the integration **must** be done on a public-accessible URL (ie. by using [ngrok](https://ngrok.com/)) because Setefi backend needs to be able to do valid server-to-server requests for the process to complete successfully.)*

Setefi sandbox environment
--------------------------

[](#setefi-sandbox-environment)

Log in to [Setefi's sandbox environment](https://test.monetaonline.it/monetaweb/backoffice):

*(**Note:** these are documented by Setefi and shared among all sandbox users, they're NOT a secret)*

- *Codice Commerciante:* `009999999`
- *Codice Utente:* `009999999`
- *Password:* `Setefi14`

Note that your transactions will be among all other sandbox's users' transactions, you need to find your own to verify it works.

Technical implementation
------------------------

[](#technical-implementation)

- Entrypoint is [`Webburza\Payum\Setefi\SetefiGatewayFactory`](src/SetefiGatewayFactory.php) which registers all known actions, sets up config and creates a new `Api`.
- [`Webburza\Payum\Setefi\Api`](src/Api.php) is a collection of helpers and constants specific to this provider, it gets injected to all actions implementing `Payum\Core\ApiAwareInterface`.
- Every action has a specific task and they declare on which part of the process they work on by implementing `support($request)` from `Payum\Core\Action\ActionInterface`. The action name itself does not matter.
    For example, `Webburza\Payum\Setefi\Action\CancelAction` declares it can handle `Payum\Core\Request\Cancel` request and it will receive all those types of requests to handle.
    **Action and the request are two different things**, you can (and do) have much more actions than you do request types (some gateways have no custom request types).
- We can also define some custom request types such as [`Webburza\Payum\Setefi\Request\CreateTransaction`](src/Request/CreateTransaction.php) for situations where domain-specific events need to happen. After having defined them, we register actions to handle them the same way we do native actions.

Transaction sequence
--------------------

[](#transaction-sequence)

1. `Webburza\Payum\Setefi\Action\StatusAction` marks the payment request as `new`
2. `Webburza\Payum\Setefi\Action\CaptureAction` triggers `Webburza\Payum\Setefi\Request\CreateTransaction` request
3. a new Setefi transaction is created using `Webburza\Payum\Setefi\Action\CreateTransactionAction` and a server-to-server (S2S) request
4. if successful, the user is redirected to Setefi web interface
5. 1. if payment successful, Setefi does a S2S request and `Webburza\Payum\Setefi\Action\StatusAction` marks the payment request as `captured`
    2. if payment not successful, Setefi does a S2S request and `Webburza\Payum\Setefi\Action\StatusAction` marks the payment request as `canceled`
6. response to 5. is a valid redirect URL for Setefi to redirect to user back to
7. process complete

[![Transaction sequence](https://camo.githubusercontent.com/484f8bb215a2d04a50ef33842709a3c6cab15c54c8ce585cc3ab91660bd43fc4/687474703a2f2f7777772e706c616e74756d6c2e636f6d2f706c616e74756d6c2f70726f78793f7372633d68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f7765626275727a612f706179756d2d7365746566692f6d61737465722f646f63732f7472616e73616374696f6e2e70756d6c2333)](https://camo.githubusercontent.com/484f8bb215a2d04a50ef33842709a3c6cab15c54c8ce585cc3ab91660bd43fc4/687474703a2f2f7777772e706c616e74756d6c2e636f6d2f706c616e74756d6c2f70726f78793f7372633d68747470733a2f2f7261772e67697468756275736572636f6e74656e742e636f6d2f7765626275727a612f706179756d2d7365746566692f6d61737465722f646f63732f7472616e73616374696f6e2e70756d6c2333)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~64 days

Total

5

Last Release

3221d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0d2c966196cdd33799a39abc3bef8f86fca23a295a1a7894d64308a2fab609c?d=identicon)[damijank](/maintainers/damijank)

![](https://www.gravatar.com/avatar/7be35f354249944b168f250d5231af64cf86f1994205ce86df5dff8501f3c205?d=identicon)[wellwho](/maintainers/wellwho)

![](https://www.gravatar.com/avatar/4dca25dc48256f6d8546e3ccd768f039803e6719f6427e6d3ef6fc8123171648?d=identicon)[njava](/maintainers/njava)

---

Top Contributors

[![dkarlovi](https://avatars.githubusercontent.com/u/209225?v=4)](https://github.com/dkarlovi "dkarlovi (2 commits)")[![ychanan](https://avatars.githubusercontent.com/u/6249343?v=4)](https://github.com/ychanan "ychanan (1 commits)")

---

Tags

payment-gatewaypayment-integrationpayment-processingpayumsetefisyliuspaymentpayumsetefimonetaonline

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/webburza-payum-setefi/health.svg)

```
[![Health](https://phpackages.com/badges/webburza-payum-setefi/health.svg)](https://phpackages.com/packages/webburza-payum-setefi)
```

###  Alternatives

[flux-se/payum-stripe

Payum Stripe gateways

29424.8k6](/packages/flux-se-payum-stripe)[crevillo/payum-redsys

Redsys gateway

1649.1k1](/packages/crevillo-payum-redsys)[valiton/payum-payone

The Payum extension. It provides PAYONE payment integration.

1015.2k](/packages/valiton-payum-payone)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
