GerbangPembayaranManual

GerbangPembayaranManual is a payment gateway extension for Paymenter that enables clients to choose their preferred Indonesian bank or e-wallet for manual transfers and confirm payments via WhatsApp.

Features

• Support for Up to 3 Banks or E-Wallet Accounts: Configure up to three different bank or e-wallet accounts to receive payments.
• Click-to-WhatsApp: Clients can easily confirm their payments by clicking a button that redirects them to a WhatsApp chat with the seller.
• All Currency Support: Supports transactions in all currencies configured in the settings.
• Indonesian Banks and E-Wallets: Compatible with major Indonesian banks and e-wallet services.

How It Works

1. Select Payment Method: Clients choose from the list of available banks or e-wallets during checkout.
2. Manual Transfer: Clients manually transfer the payment amount using their selected bank or e-wallet.
3. Confirm via WhatsApp: After transferring, clients click a button to confirm the payment through WhatsApp messaging with the seller.

Installation

Option 1: Install via One-line script

1. SSH to Paymenter Machine

2. Installation

Execute the command below:

git clone https://github.com/Adekabang/GerbangPembayaranManual.git /var/www/paymenter/extensions/Gateways/GerbangPembayaranManual

3. Build the Assets

Follow this link for build the assets of the extension:

https://paymenter.org/development/theme/assets

4. Activate the Extension:

   • Log in to your Paymenter admin panel.
   • Navigate to Extensions > Gateways.
   • Click "Create New Gateway".
   • Find GerbangPembayaranManual, set a name, and click the "Create" button.

5. Configuration

   • On the Gateways List, edit the GPM entry.
   • Fill out the required fields.

Option 2: Manual Installation via GitHub

1. Download the Extension:

   • Download the ZIP file from Github.

2. Upload to Paymenter:

   • Place the GerbangPembayaranManual folder into the /var/www/paymenter/extensions/Gateways/GerbangPembayaranManual directory of your Paymenter installation.

3. Activate the Extension:

   • Log in to your Paymenter admin panel.
   • Navigate to Extensions > Gateways.
   • Click "Create New Gateway".
   • Find GerbangPembayaranManual, set a name, and click the "Create" button.

4. Configuration

   • On the Gateways List, edit the GPM entry.
   • Fill out the required fields.

Configuration

After activating the extension, you need to configure it with your bank or e-wallet account details and other settings.

Configuration Fields

Here are the fields that you need to fill in:

• Order ID Prefix (order_id_prefix):

  • Type: Text
  • Placeholder: Order ID Prefix
  • Required: No
  • Description: A prefix to be added to all order IDs.

• Payment Confirmation ETA (payment_confirmation_eta):

  • Type: Text
  • Placeholder: Estimate time for payment confirmation
  • Required: No
  • Description: Estimated time for confirming payments.

Payment Method 1

• Payment 1: Bank or Wallet Name (bank_name_1):

  • Type: Dropdown
  • Required: Yes
  • Options: List of supported banks or e-wallets.
  • Description: Name of the bank or e-wallet to accept payment.

• Payment 1: Merchant or Account Name (merchant_name_1):

  • Type: Text
  • Required: Yes
  • Description: Name of the merchant or account holder.

• Payment 1: Bank or Wallet Account Number (bank_account_number_1):

  • Type: Text
  • Required: Yes
  • Description: Account number of the bank or e-wallet to accept payment.

• Payment 1: QRIS Image URL (qris_image_url_1):

  • Type: Text
  • Placeholder: URL of QRIS image (only needed if QRIS is selected)
  • Required: No
  • Description: The URL for the QRIS image associated with this payment method. Only needed if the selected payment method is QRIS.

Payment Method 2 (Optional)

• Payment 2: Bank or Wallet Name (bank_name_2):

  • Type: Dropdown
  • Required: No
  • Options: List of supported banks or e-wallets.
  • Description: Name of the bank or e-wallet to accept payment.

• Payment 2: Merchant or Account Name (merchant_name_2):

  • Type: Text
  • Required: No
  • Description: Name of the merchant or account holder.

• Payment 2: Bank or Wallet Account Number (bank_account_number_2):

  • Type: Text
  • Required: No
  • Description: Account number of the bank or e-wallet to accept payment.

• Payment 2: QRIS Image URL (qris_image_url_2):

  • Type: Text
  • Placeholder: URL of QRIS image (only needed if QRIS is selected)
  • Required: No
  • Description: The URL for the QRIS image associated with this payment method. Only needed if the selected payment method is QRIS.

Payment Method 3 (Optional)

• Payment 3: Bank or Wallet Name (bank_name_3):

  • Type: Dropdown
  • Required: No
  • Options: List of supported banks or e-wallets.
  • Description: Name of the bank or e-wallet to accept payment.

• Payment 3: Merchant or Account Name (merchant_name_3):

  • Type: Text
  • Required: No
  • Description: Name of the merchant or account holder.

• Payment 3: Bank or Wallet Account Number (bank_account_number_3):

  • Type: Text
  • Required: No
  • Description: Account number of the bank or e-wallet to accept payment.

• Payment 3: QRIS Image URL (qris_image_url_3):

  • Type: Text
  • Placeholder: URL of QRIS image (only needed if QRIS is selected)
  • Required: No
  • Description: The URL for the QRIS image associated with this payment method. Only needed if the selected payment method is QRIS.

WhatsApp Configuration

• WhatsApp Number (whatsapp_number):

  • Type: Text
  • Placeholder: WhatsApp Number for Sending Confirmation (format 628xxxxxxxxx)
  • Required: Yes
  • Description: Your WhatsApp number in the format 628xxxxxxxxx.

• Confirmation Message (confirmation_message):

  • Type: Text
  • Placeholder: e.g., "Halo Admin, berikut bukti pembayaran sewa cloud"
  • Required: Yes
  • Description: The message that customers will send via WhatsApp to confirm their payment.

Steps to Configure

1. Navigate to the Extension Settings:

   • In the Paymenter admin panel, go to Extensions > Gateways.
   • Click "New Gateway".
   • Choose GerbangPembayaranManual.
   • Click "Create".

2. Fill in the Required Fields:

   • Enter the Order ID Prefix (optional).
   • Set the Payment Confirmation ETA (optional).

3. Configure Payment Methods:

   • For Payment 1, select the Bank or Wallet Name from the dropdown, and fill in the Merchant Name, Account Number, and optionally the QRIS Image URL if QRIS is selected.
   • Optionally, repeat the above step for Payment 2 and Payment 3.

4. Set Up WhatsApp Details:

   • Enter your WhatsApp Number in the format 628xxxxxxxxx.
   • Define the Confirmation Message that customers will send.

5. Save the Settings.

Usage

• For Clients:

  1. During checkout, select GerbangPembayaranManual as the payment method.
  2. Choose your preferred bank or e-wallet from the available options.
  3. Transfer the payment amount manually using the provided account details and/or scan the QRIS code if applicable.
  4. Click the Send payment document via Whatsapp button to send the predefined message and confirm the payment.

• For Sellers:

  • Ensure your WhatsApp contact information and configured bank/e-wallet details are correct.
  • Monitor WhatsApp for payment confirmations from clients.
  • Verify the payment and process the order accordingly.

Requirements

• Paymenter: Ensure you have Paymenter installed and properly configured.
• WhatsApp: Clients need WhatsApp installed on their device to confirm payments.
• Indonesian Bank/E-Wallet Accounts: Only Indonesian financial institutions are supported.

Screenshot

Below is a screenshot of the GerbangPembayaranManual extension in action:

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch: git checkout -b feature/your-feature-name.
3. Commit your changes: git commit -m 'Add some feature'.
4. Push to the branch: git push origin feature/your-feature-name.
5. Open a pull request.

License

This project is licensed under the MIT License.