glitchr / omnitrade

1.x-dev 2026-10-02 02:09 UTC

Requires

• php: >=8.2
• symfony/http-client-contracts: ^3.0

Requires (Dev)

• phpunit/phpunit: ^11.0
• symfony/config: ^6.4|^7.0|^8.0
• symfony/dependency-injection: ^6.4|^7.0|^8.0
• symfony/http-client: ^6.4|^7.0|^8.0
• symfony/http-kernel: ^6.4|^7.0|^8.0

Suggests

• omnitrade/paypal: PayPal: orders, captures, refunds, webhooks
• omnitrade/shopify: Shopify: draft orders paid on its invoice page, orders, webhooks
• omnitrade/stripe: Stripe: cards and wallets through Checkout, refunds, webhooks
• omnitrade/woocommerce: WooCommerce: orders and their payment state over the REST API
• symfony/http-client: The HTTP client the providers talk through

LGPL-3.0-or-later

• Marco Meyer

• payment
• gateway
• paypal
• stripe
• shopify
• woocommerce
• omnitrade

Published on Packagist.org on 2026-10-02 02:10 UTC

README

One contract for payment providers and commerce platforms - the Omnibus of trade.

$gateway = $registry->get('card');
$transaction = $gateway->purchase($payment);   // PAID, or PENDING with the page to send the buyer to
$gateway->fetch($transaction->reference);      // where it stands now
$gateway->refund($transaction->reference, Money::of(500, 'EUR'), idempotencyKey: 'refund-42');
$gateway->notify($request->getContent(), $request->headers->all());   // a webhook, checked and read

This package holds the contract (GatewayInterface, GatewayFactory, Registry), the models (Payment, Money, Transaction, Refund, PaymentMethod, Notification, PlatformOrder...), the requests and the Symfony bundle. Each provider is a package of its own:

Package	Provider
omnitrade/stripe	Stripe: Checkout sessions, refunds, webhooks (on omnipay/stripe)
omnitrade/paypal	PayPal: orders, capture, refunds, webhooks (on omnipay/paypal)
omnitrade/shopify	Shopify: draft orders paid on the invoice page, orders, webhooks (Admin GraphQL)
omnitrade/woocommerce	WooCommerce: orders and their payment state (REST API v3)

A provider's factory fills a Config - its name, options, API client and actions - and the gateway runs the actions that support each request, exactly as an Omnibus carrier does. A provider that does not do something (no authorizations at Shopify) throws RequestNotSupportedException; supports() says so beforehand.

What every provider answers with is kept whole in $raw: normalization loses nothing.

Symfony

Omnitrade\Bridge\Symfony\OmnitradeBundle: every omnitrade/* provider installed registered, Omnitrade\Registry autowired, and each configured gateway injectable by its name.

omnitrade:
    gateways:
        card:   { factory: stripe, options: { api_key: '%env(STRIPE_API_KEY)%', webhook_secret: '%env(STRIPE_WEBHOOK_SECRET)%' } }
        paypal: { factory: paypal, options: { client_id: '%env(PAYPAL_CLIENT_ID)%', secret: '%env(PAYPAL_SECRET)%', sandbox: true } }

public function __construct(GatewayInterface $card) {}

An application's own GatewayFactoryInterface is registered too (autoconfigured).

Docker: every provider with your test keys

docker/ runs this package with every omnitrade/* provider installed - from GitHub, or from the checkouts beside this one when OMNITRADE_PLUGINS=../.. is set - and a console that exercises them with the keys in docker/.env (copy .env.dist; docker compose run --rm omnitrade gateways says which providers are configured and what each one does):

cd docker && cp .env.dist .env
docker compose run --rm omnitrade gateways
docker compose run --rm omnitrade purchase stripe --amount 1990      # prints the Checkout page to open
docker compose run --rm omnitrade fetch stripe cs_test_...
docker compose run --rm omnitrade refund stripe cs_test_... --amount 500
docker compose run --rm omnitrade notify stripe -H 'Stripe-Signature: t=...,v1=...' < event.json
docker compose run --rm omnitrade test                               # every package's tests

License: LGPL-3.0-or-later.