Official WooCommerce Plugin

This documentation explains the steps to install and use the official iPaymu Payment Gateway for WooCommerce plugin.

---

Step 1: Set Callback Type to JSON

The first step is to ensure that iPaymu sends Webhook Callbacks to your WooCommerce store in JSON format.

1. Open the iPaymu dashboard and click the Settings (Gear) icon.
2. On the settings page, navigate to the Integration tab (or open https://sandbox.ipaymu.com/integration/setting for Sandbox).
3. Under the Integration Settings section, locate the Callback Notification input.
4. Change the type from application/x-www-form-urlencoded (legacy) to application/json.
5. Save the settings.

---

Step 2: Install the WooCommerce Plugin

1. Log into your WP Admin dashboard (ensure you have the latest version of WooCommerce installed and set up).
2. Go to the menu Plugins -> Add New.
3. Search using the keyword iPaymu Payment Gateway for WooCommerce by iPaymu.
4. Click Install, then click Activate to enable the plugin.

---

Step 3: Configure Credentials

1. Navigate to the WooCommerce -> Settings menu.

2. Select the Payments tab.

3. Look for iPaymu Payment Gateway, enable its toggle, then click Manage.

4. On this settings page, you can enter the VA and API Key of your iPaymu account. There are 4 fields: 2 for Production and 2 for Sandbox.

5. If you want to test payments first, check the Test mode / Sandbox option.

6. Click Save changes at the bottom.

---

Step 4: Test Payment (Checkout)

If you have configured the sandbox credentials and enabled Test mode, you can try creating a payment.

1. Make a purchase in the store like a regular customer.

2. On the Checkout page, select the iPaymu Payment method.

3. Click Place Order / Checkout, and you will be redirected to the iPaymu payment page.

---

Step 5: Test Webhooks in Sandbox

To try testing a successful payment Callback in Sandbox mode:

1. Copy the Transaction ID or Ref ID (the example in the image is 196984).

2. Visit the page https://sandbox.ipaymu.com/notify.

3. Paste the Ref ID into the column labeled iPaymu Transaction ID / Merchant Ref ID / Session ID.

4. Click Submit.

You will then see the Request Header and Request Body that the iPaymu server attempted to send to your WooCommerce site. You can inspect this JSON Response and Body if there are communication errors. You can also use this mock payload to manually hit your localhost server via Postman.