midtrans / snap
Midtrans Accept Online Payment Magento 2 module
Installs: 3 966
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 9
Forks: 8
Open Issues: 2
Type:magento2-module
Requires
- php: ^5.5 || ^7.0 || ^8.0
This package is auto-updated.
Last update: 2024-11-05 11:24:20 UTC
README
Midtrans ❤️ Magento! Midtrans strive to make payments simple for both the merchant and customers. With Midtrans Magento extension/plugin, your Magento Store can easily start accepting payments via Midtrans.
Live Demo
Want to see Midtrans Magento payment plugins in action? We have some demo web-stores for Magento that you can use to try the payment journey directly, click the link below.
Requirements:
- An online store with Magento infrastructure. This plugin tested with Magento v2.1.0, v2.2.0, v2.3.1, v2.4.1
- PHP v5.6 or greater.
- MySQL v5.7 or greater.
- Midtrans plugin for Magento v2.x [ Github | Zip ]
- This plugin supports Magento2 version 2.1.0 - 2.4.1 and higher.
How to install the plugins
Install Midtrans Snap plugins through Composer
Before you begin to install through the composer, you need Magento marketplace account and make sure that you have installed Composer. In your terminal, go to the Magento folder and run the following commands:
- Install the plugins:
composer require midtrans/snap
- Enable the plugin:
bin/magento module:enable Midtrans_Snap
- Execute upgrade script :
bin/magento setup:upgrade
- Clean cache storage :
bin/magento cache:clean
- Check the module status:
bin/magento module:status Midtrans_Snap
Note: If you do have a previous version installed and upgrade the plugins to the latest version. After upgrade our plugins, You need to run
bin/magento setup:upgrade --keep-generated
,bin/magento setup:static-content:deploy
and clean cachebin/magento cachce:clean
.
Install Midtrans Snap plugins through Magento marketplace
You can install Midtrans Snap plugins through Magento Marketplace. Please, visit Midtrans on Magento Marketplace and follow step-by-step installation instructions from the Official Magento extension docs
Install Midtrans Snap plugins from GitHub project
With these steps, you can custom/modify our Magento plugins to handle the business model that you want
-
Download and extract the plugin you have previously downloaded from GitHub and rename the folder as Snap.
-
Locate the root Magento directory of your shop via FTP connection.
-
Copy the app folders into the Magento root folder.
-
Run this command on terminal
bin/magento module:enable Midtrans_Snap
bin/magento setup:upgrade
bin/magento cache:clean
bin/magento module:status Midtrans_Snap
Plugin Usage Instruction
Basic Plugins Configuration
Before you begin, make sure that you have successfully installed and enabled Midtrans Snap plugins. Configure the Midtrans plugin in your Magento admin panel:
- Log in to your Magento admin panel.
- In the left navigation bar, go to Stores(1) -> Configuration(2).
- In the menu, go to Sales(3) -> Payment Methods(4)
- In the Midtrans - Accept Online Payment section, click Basic Settings and fill out the following fields:
Note: Access Keys are unique for every merchant. Server Key is secret, please always keep Server Key confidential.
Log options
The plugins will store log file in directory /var/log/midtrans
. The default value is on for request, notification and error log. Except Throw Exception, is off by default.
Config Plugins Payment Integration
In the Midtrans Magento plugins we have 4 option to use Snap model payment method, with the following description:
-
Snap payment integration
This is the default Snap for Midtrans Magento plugins, Snap payment will be auto-enabled when installing the Midtrans plugins. Midtrans will show the available payment method on the Snap payment screen.
-
Specific Payment integration | Optional
Enabling this will display additional payment options to customer, for specific payment that are specified in the "Allowed Payment Method" field, Midtrans Snap will show only the listed payment method on the Snap screen.
-
Online Installment payment integration | Optional
Enabling this will display additional payment options to customer, for online installment payment where the Card Issuer and Acquiring Bank is the same entity (e.g: BNI Card and BNI Acquiring bank).
-
Offline Installment payment integration | Optional
Enabling this will display additional payment options to customer, for offline Installment where the Card Issuer and Acquiring Bank don't have to be same entity (e.g: BNI Card and Mandiri Acquiring Bank)
Note: You can use different Midtrans Account for every Snap model payment method, should configure the access-key in Optional section
“Use different Midtrans account”
. If the optional access-key is empty, the plugins will automatically use access key on Basic Settings.
INFO:
The built-in BCA Klikpay landing page for now will only use server key from basic settings of Snap payment integration. Multishipping only support on version Midtrans Magento Plugins v2.5.3 or greater and not support in offline installment payment
In case you need to customize configuration these field are configurable, and described as follows:
Midtrans MAP Configuration
-
Login to your Midtrans Account, select your environment (sandbox/production), go to menu
settings -> configuration
- Payment Notification URL:
https://[your-site-url]/snap/payment/notification
- Finish Redirect URL:
https://[your-site-url]/snap/index/finish
- Unfinish Redirect URL:
https://[your-site-url]/snap/index/finish
- Error Redirect URL:
https://[your-site-url]/snap/index/finish
-
Go to menu settings > Snap Preference > System Settings
- Insert
https://[your-site-url]/snap/index/finish
link as Finish/Unfinish/Error Redirect URL.
How to online refund transaction
Click to expand info
You can request refunds either from the Midtrans Dashboard or from the Magento admin. After a refund is issued, it cannot be cancelled or undone. Before you trigger this request, make sure that the refund amount and any other details are correct.
If you make refund from the Midtrans Dashboard, Refund notification is sent to Magento, set transaction state to CLOSED and for now is not created the credit memo.
Request refund from Magento Admin:
-
Log in to your Magento admin panel.
-
In the menu, go to Sales > Orders. This opens the order overview page.
-
Click on the order you want to refund.
-
In the Order list View left-hand navigation sidebar, click Invoices tab.
-
In the invoice list page, selected the order. click the view button on invoice you need to request online refund.
-
Click Credit Memo on the top-right corner of the page.
-
In the New Memo for Invoice page, scroll down to the Refund Totals section.
-
In this section, you can request online Refund or Refund Offline.
- Refund: This option will request refund Online to Midtrans, Midtrans automatically send refund notification and changes order status to Closed from notification.
- Refund Offline: An offline refund does not trigger request refund to midtrans it’s only refund in Magento side. You need to take action and carry out the refund manually from Midtrans dashboard.After a refund operation, the order status changes to Closed. This order status change is controlled by the Magento system.
The status change may not mean that the refund has carried out successfully on Midtrans side. When the transaction status in Midtrans dashboard changes to REFUND, then the refund went through successfully
Configuring Custom Payment Fee
In case you need it, payment fee can optionally be added by using additional (3rd party) extension: Mageprince Magento2 PaymentFee extension. It allows adding extra charges for specific payment methods and displays them on the cart page, checkout page, invoice, and credit memo.
All the fee calculation will be handled by that extension. Midtrans extension will then take the produced PaymentFee value (from Magento order object), and parse it into additional item object for Midtrans API param.
Example on how to use the PaymentFee Extension
Click to expand info
You can try the demo extension here
Installation & Configuration Instructions
You can install from Magento Marketplace or follow the manual installation step.
How to configure the extension
- Go to menu
Stores -> Configuration -> MagePrince -> Payment Fee
- Set Enable field to
Yes
- Go to
Payment Fee Settings
section, choosePriceType
, Fill inMinimum
andMaximum order amount
. - Click
Add Fee
button, then choose Midtrans Payment method onPayment Method Fee
and Fill inFee Amount
- Click
Save Config
This is just an example configuration that works at the time of this writing, the extension may change in the future. For further & most up to date details of Mageprince PaymentFee extension configuration, you can check the official extension documentation.
Get help
- General Documentation Midtrans
- Please follow this step by step guide for complete configuration. If you have any feedback or request, please do let us know here.
- Technical Support Team Midtrans support@midtrans.com
- Midtrans Magento Demo Store
- SNAP Documentation Product Midtrans
- CoreAPI Documentation Product Midtrans
- Mobile Documentation Product Midtrans