New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

betalabs/engine-sdk-gateway

Gateway SDK for internal apps Engine
22,312
Install
composer require betalabs/engine-sdk-gateway
Latest Version:5.3.7
PHP:>=7.2
Laravel:7 · 8 · 9
Older releases:5 · 6
License:MIT
Last Updated:Oct 28, 2026
Links: GitHub  ·  Packagist
Maintainer: diego-betalabs

engine-sdk-gateway

This package provides gateway interfaces used in Engine for your internal apps.

Installation

$ composer require betalabs/engine-sdk-gateway

Pix Automático (recurring Pix debit)

Optional contract for gateways that support Pix Automático. A gateway driver opts in by implementing the two interfaces below; Engine checks instanceof and refuses the payment method when the driver does not implement them, so drivers that do not support it are not affected.

Interface Role
PixAutomaticAuthorizer authorizePixAutomatic, refreshPixAutomaticAuthorization, cancelPixAutomaticAuthorization
PixAutomaticCharger schedulePixAutomaticCharge, retryPixAutomaticCharge, cancelPixAutomaticCharge
PixAutomaticAuthorization The authorization itself. Implemented by Engine (a persisted model), like Transaction: the gateway reads what to create from the getters and writes the gateway's answer through the setters.

How it maps to what already exists:

  • The authorization plays the role the tokenized card plays for credit cards: it is created once per subscription, after the payer approves it in the bank app.
  • Each cycle is a scheduled debit (schedulePixAutomaticCharge) created days before the due date. Nothing is paid when it returns: the Transaction is waiting payment and the final status arrives later (postback or polling), using the existing TransactionStatus.
  • A debit refused for lack of balance is the only retryable one. The gateway must say which kind of failure it was in the history's status reason.
  • Enums (PixAutomaticPeriodicity, PixAutomaticAmountMode, PixAutomaticAuthorizationStatus) use the Central Bank of Brazil's concepts, not any gateway's vocabulary: each driver translates them.

Design and rollout: docs/payments/pix-automatico-plano.md in the Engine repository.

Related Packages

betalabs/engine-sdk-freight

Freight SDK for internal apps Engine

21,443 0
betalabs/engine-contracts

Contracts to establish communication between Engine and your internal apps

22,157 0
neclimdul/marketo-rest

Marketo Rest API library

122,781 1
orzcc/taobao-top-client

Taobao top client(SDK) for laravel

26,152 105
postnl/postnl-ecommerce-sdk

Collection of PostNL API's for ecommerce processes.

9,425 0

Version History

Version Released PHP Laravel License
5.3.7 >=7.2 ^7.0|^8.0|^9.0 MIT
5.3.6 >=7.2 ^7.0|^8.0|^9.0 MIT
5.3.5 >=7.2 ^7.0|^8.0|^9.0 MIT
5.3.4 >=7.2 ^7.0|^8.0|^9.0 MIT
5.3.3 >=7.2 ^7.0|^8.0|^9.0 MIT