Midtrans  WooCommerce - Wordpress Payment Gateway Module

Midtrans  ❤️ WooCommerce! Receive online payment on your WooCommerce store with Midtrans payment gateway integration plugin.

Also Available on Wordpress plugin store

Description

This plugin will allow secure online payment on your WooCommerce store, without your customer ever need to leave your WooCommerce store! With beautiful responsive payment interface built-in. Midtrans  is an online payment gateway. They strive to make payments simple for both the merchant and customers. Support various online payment channel. Support WooCommerce v3 & v2.

Payment Method Feature:

• Credit card fullpayment and other payment methods.
• Bank transfer, internet banking for various banks
• Credit card Online & offline installment payment.
• Credit card BIN, bank transfer, and other channel promo payment.
• Credit card MIGS acquiring channel.
• Custom expiry.
• Two-click & One-click feature.
• Midtrans Snap all payment method fullpayment.

Installation

Minimum Requirements

• WordPress v3.9 or greater (tested up to v5.0.0)
• WooCommerce v2 or greater (tested up to v3.5.2)
• PHP version v5.4 or greater
• MySQL version v5.0 or greater
• PHP CURL enabled server/host

Simple Installation

1. Login to your Wordpress admin panel.
2. Go to Plugins menu, click add new. Search for Midtrans-WooCommerce plugin.
3. Install and follow on screen instructions.
4. Proceed to step 5 below.

Manual Installation

1. Download the plugin from this repository.
2. Extract the plugin, then rename the folder modules as midtrans-woocommerce
3. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's wp-content/plugins/ directory.
4. Install & Activate the plugin from the Plugins menu within the WordPress admin panel.
5. Go to menu WooCommerce > Settings > Payment > Midtrans > Manage, fill the configuration fields.
   • Fill Title with text button that you want to display to customer
   • Select Environment, Sandbox is for testing transaction, Production is for real transaction
   • Fill in the client key & server key with your corresonding Midtrans  account credentials
   • Note: key for Sandbox & Production is different, make sure you use the correct one.
   • Other configuration are optional, you may leave it as is.

Midtrans  MAP Configuration

1. Login to your Midtrans  Account, select your environment (sandbox/production), go to menu settings > configuration

• Insert http://[your web]/?wc-api=WC_Gateway_Midtrans as your Payment Notification URL.
• Insert http://[your web]/?wc-api=WC_Gateway_Midtrans link as Finish/Unfinish/Error Redirect URL.

2. Go to menu settings > Snap Preference > System Settings

• Insert http://[your web]/?wc-api=WC_Gateway_Midtrans link as Finish/Unfinish/Error Redirect URL.

Additional Resource

Note: This section is optional and only for advanced usage.

Configurables

Available for customization from plugin config:

• Payment text label of the payment options
• Payment text description of the payment options
• You can also input html tags as the text, to insert something like image

Additional payment options (radio button) can be activated:

• Installment
• Offline Installment
• Promo / specific payment

BCA Klikpay Specific

Click to expand info

If you are activating BCA Klikpay payment channel, follow this additional step. This step is required to pass BCA UAT on BCA Klikpay.

1. Login to Wordpress Admin Panel / Dashboard
2. Add new page by going to menu Pages > Add new
3. Insert this as title: midtrans-payment-finish. Makesure the permalink display [your wordpress url]/midtrans-payment-finish. Click Publish/Save.
4. Login to your Midtrans  Account, select your environment (sandbox/production), go to menu settings > Snap Preference > System Settings
5. Go to menu settings > configuration. Then change Finish Redirect URL to http://[your wordpress url]/midtrans-payment-finish.

This is to ensure we have finish page when customer has completed the payment on KlikPay page, and then the payment result will be displayed accordingly on the page. If you want to customize the finish page, edit this file /class/finish-url-page.php.

Note: BCA KlikPay requires you to disable the Redirect payment page configuration, on Midtrans Plugin config page. Please ensure you have done this.

If required to change API endpoint/url, these are where you need to change:

• [plugin folder]/lib/veritrans/Veritrans/Config.php

  • Replace any Snap API domain: https://app.sandbox.midtrans.com/snap/v1 with UAT API domain
  • Replace any Midtrans API domain: https://api.sandbox.midtrans.com/v2 with UAT API domain

• [plugin folder]/class/payment-page.php

  • Replace any Snap API domain: https://app.sandbox.midtrans.com with UAT API domain

Customizing Snap API parameters

Click to expand info

In case you need to do customization on Snap API parameters that is not provided by default from this plugin.

For All Payments in This Plugin

If you want the API params to be applied to all payment options within this plugin, you can edit:

• File ./abstract/abstract.midtrans-gateway.php
  • Within function getPaymentRequestData
  • Before line return $params;
• There you can modify the $params variable, it is an PHP Array representation of Snap's API JSON param.

For example, you can add "custom finish url":

$params['callbacks'] = array();
$params['callbacks']['finish'] = "https://mywebsite.com/my-custom-finish-url/";

return $params;

For Specific Payment Option in This Plugin

If you want it to be applied to just some specific Payment Option (e.g: the default/fullpayment only, or installment only, etc.)

• Select the file from folder ./class/,
  • Choose the file based on your desired Payment Option, for example file ./class/class.midtrans-gateway-installment.php
  • Within function process_payment
  • Before line $woocommerce->cart->empty_cart();
• There you can modify the $params variable, it is an PHP Array representation of Snap's API JSON param.

Get help

• SNAP-Woocommerce Wiki
• Veritrans registration
• SNAP documentation
• Can't find answer you looking for? email to support@midtrans.com