Download the PHP package zarulizham/laravel-fpx without Composer

Laravel FPX

This package provides Laravel implementations for Paynet FPX services.

Shipped with transaction viewer (available in dark mode)

Simple query FPX transaction and view status including request and response payload.

Installation

You can install the package via composer:

Then run the publish command to publish the config files and support controller

This will generate the following files

• The config file with default setup for you to override fpx.php
• The controller that will receive payment response and any host-to-host events Http/Controllers/FPX/Controller.php
• The assets in public directory.
• The view file with default html for you to override payment.blade.php. Note do not change form action URL fpx.payment.auth.request.

Setups

1. Add your redirect urls and your Seller and Exchange Id to the .env file.

2. You can skip this steps, if you have already generated CSR. Visit fpx/csr/request path in browser to generate CSR.

   http://app.test/fpx/csr/request

   Fill the form and click on GENERATE. On right side textarea will be generated with openSSL code. Download openSSL from https://www.openssl.org/ if you don't have installed it. Run openssl code to generate CSR. Submit this CSR to FPX service provider to get the Exchange Certificates.

3. After generating your certificates add them to your app. By default, we look for the certificates inside the following directives. Create fpx/uat and fpx/prod directories in storage/app/public directory and paste your certificates there. You can find UAT certificate in uat certificate/fpxuat_current.cur rename it with your Exchange ID and place it in mentioned UAT directory.

You can override the defaults by updating the config file.

3. Publish package migrations to your Laravel app

4. Run migration to add the banks and fpx_transactions table

5. Laravel 12: Exclude validate CSRF Token for FPX direct callback URL in bootstrap/app.php.

Usage

1. First run the following command to seed the banks list.

you should schedule the fpx:banks Artisan command to run daily:

2. Add one the x-fpx-payment component with the following attributes

During testing, you can use the test-mode attribute to override the provided amount to 'MYR 1.00'

3. Handle the payment response in Http/Controllers/FPX/Controller.php

4. Check Status of all pending transactions using command

5. Check Status of specific transaction using command pass comma separated order reference ids.

6. Check transaction status and Bank list from Controller

7. Restrict access to fpx/transactions routes in your AppServiceProvider.

Web Integration

You can visit http://app.test/fpx/initiate/payment for the payment flow demo of web integration.

B2B Approval / Checker

In order to approve Pending Authorization transaction, navigate here and enter transaction ID. https://simulator.fpx.uat.inet.paynet.my/UatBuyerBankSim1.7/B2BAuth.jsp

Mobile App Integration

• Append app parameter in the URL to check the demo. http://app.test/fpx/initiate/payment/app
• This will print JSON response after completion of transaction to integrate with mobile app.

Follow these steps to integrate in mobile application.

Request Details

Open http://app.test/fpx/initiate/payment/app in web view with POST method and POST below parameters.

Response

You must use response field to display receipt. fpx_response is added if you need any extra details.

response.status will be succeeded, failed or pending.

You can also override payment.blade.php with your custom design to integrate with your layout. but do not change name attribute of html controls and action URL of form.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• ZarulIzham
• AIMEN.S.A.SASI
• All Contributors

License

The MIT License (MIT). Please see License File for more information.