PHPackages                             confluxapi/magento2-payment - 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. confluxapi/magento2-payment

ActiveMagento2-module[Payment Processing](/categories/payments)

confluxapi/magento2-payment
===========================

Conflux payment integration for Magento 2.

1.0.0(yesterday)01↑2900%MITPHPPHP ^8.1

Since Jun 26Pushed yesterdayCompare

[ Source](https://github.com/ideal-source/confluxapi-magento2-payment)[ Packagist](https://packagist.org/packages/confluxapi/magento2-payment)[ Docs](https://github.com/ideal-source/confluxapi-magento2-payment)[ RSS](/packages/confluxapi-magento2-payment/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (7)Versions (3)Used By (0)

Conflux API Payment for Magento 2
=================================

[](#conflux-api-payment-for-magento-2)

[简体中文](README.zh_CN.md)

Conflux API Payment for Magento 2 provides two payment methods for Magento checkout:

- **Conflux Credit Card** (`conflux_direct`)
- **Conflux Hosted Checkout** (`conflux_checkout`)

The module creates Conflux payment requests from Magento orders, redirects customers when required, and handles Conflux payment notifications to update Magento order status.

Requirements
------------

[](#requirements)

- PHP `^8.1`
- Magento framework `^103.0`
- Magento 2 modules:
    - `Magento_Checkout`
    - `Magento_Config`
    - `Magento_Directory`
    - `Magento_Payment`
    - `Magento_Sales`
    - `Magento_Store`

Installation
------------

[](#installation)

Install the module with Composer:

```
composer require confluxapi/magento2-payment
bin/magento module:enable Conflux_Payment
bin/magento setup:upgrade
bin/magento cache:flush
```

If your Magento instance is running in production mode, also run:

```
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
```

Manual Installation
-------------------

[](#manual-installation)

If the package is not available from Packagist yet, place the module under:

```
app/code/Conflux/Payment

```

Then enable it:

```
bin/magento module:enable Conflux_Payment
bin/magento setup:upgrade
bin/magento cache:flush
```

Configuration
-------------

[](#configuration)

In Magento Admin, go to:

```
Stores > Configuration > Sales > Payment Methods

```

Configure one or both payment methods.

### Conflux Credit Card

[](#conflux-credit-card)

Configuration group:

```
Conflux Credit Card

```

Method code:

```
conflux_direct

```

Available fields:

- **Enabled**: Enable or disable the direct credit card payment method.
- **Title**: Payment method title shown at checkout.
- **New Order Status**: Initial Magento order status after order placement.
- **API Base URL**: Full Conflux API endpoint provided by Conflux.
- **App ID**: Conflux API application ID.
- **App Secret**: Conflux API secret. This value is stored encrypted by Magento.
- **Merchant Number**: Conflux merchant number.
- **Gateway Number**: Conflux gateway number.
- **Payment from Applicable Countries**: Allow all countries or only selected countries.
- **Payment from Specific Countries**: Country allowlist when specific countries are enabled.
- **Minimum Order Total**: Minimum order total allowed for this payment method.
- **Maximum Order Total**: Maximum order total allowed for this payment method.
- **Sort Order**: Display order in checkout.

### Conflux Hosted Checkout

[](#conflux-hosted-checkout)

Configuration group:

```
Conflux Hosted Checkout

```

Method code:

```
conflux_checkout

```

Available fields:

- **Enabled**: Enable or disable the hosted checkout payment method.
- **Title**: Payment method title shown at checkout.
- **New Order Status**: Initial Magento order status after order placement.
- **API Base URL**: Full Conflux API endpoint provided by Conflux.
- **App ID**: Conflux API application ID.
- **App Secret**: Conflux API secret. This value is stored encrypted by Magento.
- **Merchant Number**: Conflux merchant number.
- **Gateway Number**: Conflux gateway number.
- **Checkout Expires In Seconds**: Hosted checkout expiration time. The module enforces a range from `7200` to `86400` seconds.
- **Payment from Applicable Countries**: Allow all countries or only selected countries.
- **Payment from Specific Countries**: Country allowlist when specific countries are enabled.
- **Minimum Order Total**: Minimum order total allowed for this payment method.
- **Maximum Order Total**: Maximum order total allowed for this payment method.
- **Sort Order**: Display order in checkout.

Conflux URLs
------------

[](#conflux-urls)

The module sends these URLs to Conflux when creating payments.

### Notification URL

[](#notification-url)

```
https://your-domain.com/conflux/notify/index

```

Conflux should send payment notifications to this URL with the `POST` method.

### Hosted Checkout Cancel URL

[](#hosted-checkout-cancel-url)

```
https://your-domain.com/conflux/checkout/cancel

```

Customers are returned to this URL when they cancel hosted checkout.

### Success URL

[](#success-url)

```
https://your-domain.com/checkout/onepage/success

```

Customers are returned to Magento's standard checkout success page after payment flow completion.

Payment Notification Handling
-----------------------------

[](#payment-notification-handling)

The notification controller accepts Conflux `PAYMENT` notifications.

The module uses the Magento order increment ID from:

```
data.mch_order_no

```

Expected notification behavior:

- `trade_status = SUCCESS`: order state and status are set to `processing`.
- `trade_status = FAILED`: order is cancelled when Magento allows cancellation.
- Duplicate notifications with the same `notify_id` are ignored after the first successful handling.
- Invalid JSON, unknown orders, invalid payment methods, or invalid signatures return an error HTTP response.

Testing
-------

[](#testing)

Use the sandbox API base URL first.

Recommended test flow:

1. Enable one payment method in Magento Admin.
2. Configure `API Base URL`, `App ID`, `App Secret`, `Merchant Number`, and `Gateway Number`.
3. Clear Magento cache.
4. Place a frontend order using the enabled Conflux payment method.
5. Confirm the customer is redirected or payment is started correctly.
6. Trigger a Conflux payment notification.
7. Confirm the Magento order moves to `processing` after a successful payment.

Useful Magento commands:

```
bin/magento module:status Conflux_Payment
bin/magento cache:flush
bin/magento setup:upgrade
```

Troubleshooting
---------------

[](#troubleshooting)

### Payment method is not shown at checkout

[](#payment-method-is-not-shown-at-checkout)

Check:

- The payment method is enabled in Magento Admin.
- Magento cache has been flushed.
- The order country is allowed by the payment method country settings.
- The order total is within the configured minimum and maximum order total range.

### API credentials error

[](#api-credentials-error)

Confirm these fields are configured for the selected payment method:

- App ID
- App Secret
- Merchant Number
- Gateway Number

Also confirm the configured API base URL matches the credentials:

- Sandbox API base URL
- Production API base URL

### Notification does not update the order

[](#notification-does-not-update-the-order)

Check:

- Conflux can access `https://your-domain.com/conflux/notify/index`.
- The notification uses `POST`.
- `data.mch_order_no` matches the Magento order increment ID.
- The order payment method is `conflux_direct` or `conflux_checkout`.
- The notification signature is generated with the matching App Secret.

Package Name
------------

[](#package-name)

```
confluxapi/magento2-payment

```

Module Name
-----------

[](#module-name)

```
Conflux_Payment

```

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/28700483?v=4)[ideal](/maintainers/ideal-source)[@ideal-source](https://github.com/ideal-source)

---

Tags

paymentcheckoutmagento2magento2 moduleconflux

### Embed Badge

![Health badge](/badges/confluxapi-magento2-payment/health.svg)

```
[![Health](https://phpackages.com/badges/confluxapi-magento2-payment/health.svg)](https://phpackages.com/packages/confluxapi-magento2-payment)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1121.8M12](/packages/mollie-magento2)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68353.9k](/packages/run-as-root-magento2-prometheus-exporter)[amzn/amazon-pay-magento-2-module

Official Magento2 Plugin to integrate with Amazon Pay

108521.2k1](/packages/amzn-amazon-pay-magento-2-module)[buckaroo/magento2

Buckaroo Magento 2 extension

32414.8k7](/packages/buckaroo-magento2)[pagbank/payment-magento

PagBank - Payment for Magento and Adobe

2130.2k7](/packages/pagbank-payment-magento)

PHPackages © 2026

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