paypossible/payment-gateway

PayPossible Magento 2 Payment Gateway

1.0.0 2025-09-11 22:34 UTC

This package is not auto-updated.

Last update: 2025-09-12 21:12:14 UTC


README

PayPossible is a multi-lender platform that provides financing and leasing options at the point of sale. This extension integrates the PayPossible Payment Gateway into Magento 2, enabling merchants to offer flexible payment options to their customers.

Features

  • Seamless integration with PayPossible's API for financing and leasing options.
  • Configurable in Magento's admin panel with options for test mode, merchant ID, and custom API tokens.
  • Redirects customers to PayPossible's secure payment page for completing the checkout.
  • Handles callback responses to update order status automatically.
  • Supports full order lifecycle operations such as capturing, voiding, and refunding orders.

Requirements

  • PHP 7.4+ or 8.1+
  • Magento 2.4+
  • PayPossible API credentials (merchant ID, merchant token)

Installation

1. Install via Composer

Navigate to the root of your Magento 2 installation and run the following command to install the PayPossible Payment Gateway module:

composer require paypossible/payment-gateway

2. Enable the Module

After the module is installed, enable it with Magento CLI:

php bin/magento module:enable PayPossible_PaymentGateway
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Configuration

  1. Navigate to the Magento admin panel.
  2. Go to Stores > Configuration > Sales > Payment Methods.
  3. Under the PayPossible Payment Gateway section, configure the following options:
    • Merchant ID: Your PayPossible merchant ID.
    • Merchant Token: Your PayPossible API token for authenticating requests.
    • Test Mode: Enable or disable test mode.
    • Payment Method Description: Description of the payment method displayed to customers.

Usage

  1. Customers will see the PayPossible payment option during checkout.
  2. When selected, the cart and customer data will be sent to PayPossible's API.
  3. Customers will be redirected to PayPossible to complete the financing or leasing process.
  4. Upon completion, PayPossible will redirect the customer back to your Magento store and update the order status.

Handling Callbacks

PayPossible sends order status updates via callback. The module automatically handles the following status updates:

  • Approved: Marks the order as Processing and sends an order confirmation email to the customer. 1 of 2
  • Failed: Cancels the order in Magento if the payment fails. 2 of 2

Development

Code Standards

This project follows Magento 2's coding standards, which are based on PSR-1 and PSR-2. Use phpcs to check your code before committing changes:

vendor/bin/phpcs

You can fix coding issues automatically by running:

vendor/bin/phpcbf

Testing```

To test the integration, enable Test Mode in the configuration and use the PayPossible staging environment.

Uninstall

To remove the module from your Magento 2 installation, run the following commands:

  1. Disable the module:
    php bin/magento module:disable PayPossible_PaymentGateway
  2. Remove the module via Composer:
    composer remove paypossible/payment-gateway
  3. Run Magento upgrade and cache flush:
    php bin/magento setup:upgrade
    php bin/magento cache:flush

Contributing

If you find a bug or would like to contribute to this project, please open an issue or submit a pull request on the project's repository.