Pelecard Gateway plugin for WooCommerce

Pelecard Gateway for WooCommerce

Index

Pelecard Gateway plugin for WooCommerce

Pelecard Gateway is a secure payment gateway plugin that extends WooCommerce
with Pelecard’s payment processing capabilities. Designed primarily for the Israeli market,
it offers comprehensive credit card processing with support for installment payments,
saved cards (tokenization), and multiple invoice integrations.

Credit Card Processing

Accept Visa, Mastercard, American Express, Diners, and Isracard payments securely through PCI-compliant infrastructure.

Modern Payment Methods

Support for Google Pay, Apple Pay, and Open Finance payment options alongside traditional credit card payments.

Saved Cards

Allow returning customers to save their payment information for faster checkout on future purchases.

Installment Payments

Enable customers to split payments into multiple installments with configurable min/max payment options.

Subscriptions

Full support for WooCommerce Subscriptions plugin for recurring payment products and services.

Invoice Integrations

Built-in integrations with EZCount, iCount, PayPer, and Tamal invoice providers.

Translation / Localization

The plugin is fully translated into 3 languages:

  • English (en) – Default language
  • Hebrew (he) – עברית
  • Russian (ru) – Русский

If you need to adjust or customize any translations, you can easily do so using the
Loco Translate plugin
or any other WordPress translation plugin of your choice (such as WPML, Polylang, or TranslatePress).
These tools allow you to modify existing translations or add new languages without editing the plugin files directly.

ℹ️ WordPress Directory:

https://wordpress.org/plugins/woo-pelecard-gateway/

Requirements

Requirement Minimum Version Notes
WordPress 5.0+ Recommended: Latest stable version
WooCommerce 3.0+ Required – Plugin will not function without WooCommerce
PHP 7.2+ Recommended: PHP 8.0+
SSL Certificate – Required – Site must use HTTPS
Pelecard Account – Required – Terminal credentials from Pelecard

Optional Requirements

Plugin Purpose
WooCommerce Subscriptions Required for recurring payments and subscription products
⚠️ Important: Before installation, ensure you have received your terminal credentials (Terminal Number, Username, and Password) from Pelecard support.

Installation

3.1 Install from WordPress Plugin Directory

This is the easiest and recommended installation method:

1) Access Plugin Menu

In your WordPress admin dashboard, navigate to:

Plugins → Add Plugin
2)  Search for Pelecard

In the search box on the top right, type pelecard and press Enter.

3)  Install the Plugin

Find “Pelecard Gateway” by Pelecard in the search results and click the Install Now button.

4) Activate the Plugin

After installation completes, click the Activate button to enable the plugin.

3.2 Manual Upload Installation

If you have a ZIP file of the plugin, you can upload it manually:

1) Navigate to Add Plugins
Plugins → Add Plugin → Upload Plugin
2) Upload ZIP File

Click Choose File, select the woo-pelecard-gateway.zip file, then click Install Now.

3) Activate

Once uploaded, click Activate Plugin.

✅ After Installation: You’ll see “Pelecard Gateway” in your plugins list. Click Settings under the plugin name to configure it or navigate to WooCommerce → Settings → Payments.

Configuration

Access Pelecard Gateway settings through:

WooCommerce → Settings → Payments → Pelecard gateway → Manage
or
Plugins → Pelecard Gateway → Settings

General Settings

Basic configuration options for the payment gateway:

Setting Description Options/Default
Enable/Disable Activates or deactivates Pelecard as a payment method Checkbox (default: enabled)
IFrame Language Language for the payment page Hebrew English Russian
Title Payment method name shown at checkout Default: “Pay by credit card”
Description Description shown under the payment method title Default: “Pay by credit card”
Order Button Text Text on the checkout submit button Default: “Pay by credit card”
Icon URL to custom gateway icon shown at checkout URL (must be HTTPS)
Saved Cards Allow customers to save cards for future purchases Checkbox (requires sub terminal)
Upay If enabled, transactions will not be validated Checkbox
Timeout Action What happens when the payment iframe times out Cancel Order Return to Checkout
Enable Apple Pay Support Adds ClientSecure.js to the payment page to enable Apple Pay Checkbox

Terminal Settings

Primary terminal credentials provided by Pelecard:

Setting Description
Terminal Number Your Pelecard terminal ID (e.g., 0880000001)
User Username provided by Pelecard
Password Password provided by Pelecard
Action Type Transaction type:

  • J2 – Authorization only
  • J4 – Charge (most common)
  • J5 – Charge with validation
🔐 Security Notice: Never share your terminal credentials. These should be provided directly by Pelecard and kept confidential.

Sub Terminal Settings

A second terminal is typically required for tokenization (saved cards), refunds, and subscriptions:

Setting Description
Terminal Sub terminal number for special operations
Username Sub terminal username
Password Sub terminal password
Root Terminal Enable to process foreign cards on the root terminal only (useful for subscriptions with foreign cards)

ℹ️ When is Sub Terminal Required?

  • Card tokenization (Saved Cards feature)
  • Refund processing
  • Subscription recurring payments

Payment Settings

Configure installment payment options:

Setting Description Default
Min Payments Minimum number of installments available 1
Max Payments Maximum number of installments available 12
Min Payments For Credit Minimum installments to trigger credit transaction (affects card company fees) 13

Custom Payments (Conditional Installments)

Define different payment options based on order amount, demo implementation:

Use the + Add row button to create new rules and remove selected row(s) to delete them.

Field Settings

Configure which fields appear on the payment page:

Field Options Description
First Payment Auto Manual Auto calculates first payment; Manual lets customer enter it
Card Holder Name Disabled Required Optional Cardholder name input field
Customer ID Field Disabled Required Optional ID/SSN/Passport number field
CVV2 Field Disabled Required Optional Card verification code field
Email Field Disabled Required Optional Required with value Customer email field; “Required with value” pre-fills from WooCommerce
Tel Field Disabled Required Optional Required with value Customer phone number field
Split CC Number Checkbox Divides card number input into 4 groups of 4 digits
Cancel Button Checkbox Shows cancel button to return to cart
Free Total Checkbox Shows editable “Add to total” field for donations/tips
Confirmation CheckBox Disabled Enabled Checked Requires customer confirmation before payment
Confirmation Text Text input Text displayed next to confirmation checkbox
Confirmation Link URL input Makes confirmation text a clickable link (e.g., terms page)

Design Settings

Customize the payment page appearance:

Setting Description
Top Text Text displayed at the top of the payment form
Bottom Text Text displayed at the bottom of the payment form
Supported Cards Select which card brand logos to display:

  • American Express
  • Diners
  • Isracard
  • Mastercard
  • Visa
Display Card Logos Show supported card logos at checkout
Focus on Field Which field gets focus when payment page loads: Default (none) Card Number Card Holder Name
Logo URL Custom logo displayed on payment page (must be HTTPS and whitelisted by Pelecard)
CSS URL Custom CSS file for payment page styling (must be HTTPS and whitelisted by Pelecard)
⚠️ Custom Logo/CSS: Custom Logo and CSS URLs must be whitelisted by Pelecard support before they will work. Contact Pelecard to request URL whitelisting.

Invoice Integrations

Pelecard Gateway integrates with several Israeli invoice providers:

EZCount ICount PayPer Tamal

EZCount Settings

Setting Description
Enable/Disable Enable EZCount invoice generation
API Key Your EZCount API key
Sub Account UUID for sub-account (if applicable)
Document Type Invoice type to generate (Tax Invoice Receipt, Receipt, etc.)
VAT Type Including VAT / Without VAT
Business Owner Email Email for invoice copies
Developer Email Email for technical notifications
Send Copy Send copy to business owner email
Document Language Hebrew / English

ICount Settings

Setting Description
Company ID Your iCount company identifier
Username iCount account username
Password iCount account password
Document Type Invoice type (Invoice Receipt, Receipt, Donation Receipt, Tax Invoice)
Document Language Hebrew / English
Document Remark Custom note added to invoices

PayPer Settings

Setting Description
NO VAT Generate invoices without VAT
Document Type Invoice / Proforma / Invoice-Receipt / Receipt
Document Language Hebrew / English
Send Mail Automatically email invoices to customers
Developer Email Email for technical notifications

Tamal Settings

Setting Description
Username Tamal account username
Password Tamal account password
Esek Number Business number
Osek Type Business type: Osek Mursh / Osek Patur / Amuta
Document Type Multiple options including Invoice, Quote, Receipt, Tax Invoice
Document Language Hebrew / English
Document Remark Custom note added to invoices

Checkout Experience

When properly configured, customers will see the Pelecard payment option at checkout:

Payment Selection

At checkout, customers see:

  1. Title – “Pay by credit card” (configurable)
  2. Description – Payment method description (configurable)
  3. Gateway Icon – Pelecard logo (configurable)
  4. Card Logos – Supported card brand icons (American Express, Diners, etc.)
  5. Saved Cards – Previously saved payment methods (if enabled)
  6. Number of Payments – Installment selection dropdown
  7. New Payment Method – Option to enter new card details
  8. Submit Button – Customizable button text (configurable)

Saved Card Selection

Returning customers with saved cards will see:

  • Card type and last 4 digits (e.g., “Visa ending in 3803”)
  • Expiration date
  • Number of payments selector
  • Option to use a different payment method

New Payment

When selecting “Use a new payment method”:

  • Option to save card for future purchases (checkbox)
  • Redirects to secure Pelecard payment iframe

 

Payment IFrame

When customers choose to pay with a new card, they are redirected to Pelecard’s secure payment page. This page is PCI DSS compliant and hosted by Pelecard.

IFrame Elements

# Element Description Configuration Setting
1 Logo Business logo at top of form Logo URL
2 Top Text Custom message above form Top Text
3 Card Holder Name Name/Company input Card Holder Name
4 ID Field ID/SSN/Passport input Customer Id Field
5 CVV Card verification code Cvv2 Field
6 Add to Total Extra amount field (donations/tips) Free Total
7 Number of Payments Installment selection Min/Max Payments
8 Email Customer email input Email Field
9 Phone Customer phone input Tel Field
10 Confirmation Terms acceptance checkbox Confirmation CheckBox
11 Cancel Button Returns to cart Cancel Button
12 Card Logos Accepted card brand icons Supported Cards
13 Bottom Text Custom message below form Bottom Text

Alternative Payment Methods

The payment iframe also supports:

  • Google Pay – For Android and Chrome users
  • Apple Pay – For iOS and Safari users
  • Open Finance – Bank transfer payments
ℹ️ Security: The payment iframe is hosted on Pelecard’s secure servers (gateway21.pelecard.biz) with SSL encryption and PCI DSS Level 1 compliance. Credit card data never touches your WordPress server.

Saved Cards (Tokenization)

The saved cards feature allows customers to securely store their payment information for future purchases.

Requirements

  • Saved Cards setting must be enabled
  • Sub Terminal must be configured with valid credentials
  • Customer must be logged in to their account

How It Works

  1. Customer checks “Save payment information to my account for future purchases”
  2. After successful payment, a token is stored (not actual card data)
  3. On future purchases, customer can select the saved card
  4. Only card type and last 4 digits are displayed for identification

Managing Saved Cards

Customers can manage their saved cards from:

My Account → Payment Methods
✅ Security: Pelecard stores actual card data on their PCI-compliant servers. Your WordPress site only stores a reference token.

Subscriptions Support

Pelecard Gateway fully supports WooCommerce Subscriptions for recurring payments.

Prerequisites

  • WooCommerce Subscriptions plugin installed and activated ($279/year from WooCommerce.com)
  • Sub Terminal configured (required for tokenization)
  • Valid server cron job (see important note below)

Setting Up Subscription Products

1) Create a Product

In WooCommerce > Products > Add New, set the product type to either:

  • Simple subscription – Single subscription product
  • Variable subscription – Subscription with variations
2) Configure Subscription Options
Option Description
Subscription price Recurring amount and billing frequency (daily, weekly, monthly, yearly)
Subscription length How many billing cycles before subscription ends (0 = never expires)
Sign-up fee One-time fee charged at signup
Free trial Trial period before first payment

Managing Subscriptions

View and manage subscriptions in:

WooCommerce → Subscriptions

For each subscription you can see:

  • Status (Active, On Hold, Cancelled, etc.)
  • Items and total amount
  • Start date and next payment date
  • Related orders (parent and renewal orders)

⚠️ Critical: Server Cron ConfigurationBy default, WordPress uses “wp-cron” which only runs when visitors access your site. This is NOT reliable for subscription renewals.

You must set up a real server cron job to ensure recurring payments process on time:

  1. Add to your wp-config.php: define('DISABLE_WP_CRON', true);
  2. Set up a server cron job to run every 5-15 minutes:
XML CODE:
*/5 * * * * wget -q -O - https://yoursite.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

Troubleshooting

Common Issues

Payment page doesn’t load

  • Verify terminal credentials are correct
  • Ensure your site uses HTTPS
  • Check that WooCommerce is active
  • Clear browser cache and try again

Saved cards not appearing

  • Confirm “Saved Cards” is enabled in settings
  • Verify sub terminal credentials are configured
  • Customer must be logged in
  • Check if there are any JavaScript errors in browser console

Subscription payments failing

  • Verify sub terminal is properly configured
  • Check that server cron is running (not just wp-cron)
  • Review WooCommerce > Status > Scheduled Actions for errors
  • Ensure customer’s saved card hasn’t expired

Custom logo/CSS not showing

  • URL must use HTTPS
  • URL must be whitelisted by Pelecard – contact their support
  • File must be publicly accessible

Invoice integration not working

  • Verify API credentials for the invoice provider
  • Check that only ONE invoice provider is enabled at a time
  • Review error logs for specific API errors

Debug Mode

Enable WooCommerce logging to troubleshoot issues:

WooCommerce → Status → Logs

Error Codes

Common Pelecard error codes:

Code Meaning Solution
000 Transaction approved No action needed – success
001-003 Card declined Customer should try different card
006 CVV error Customer should verify CVV
033 Card expired Customer needs valid card
036 Terminal not active Contact Pelecard support

Support

Pelecard Support

Contact Details
Website www.pelecard.com
Phone 03-6579500
Fax 08-6364007
Address Derech Eden 9, Rishon LeZion, 7570450, Israel

Plugin Support

When Contacting Support

Please provide:

  • WordPress version
  • WooCommerce version
  • Pelecard Gateway plugin version
  • PHP version
  • Error messages (from WooCommerce logs if available)
  • Steps to reproduce the issue
ℹ️ Terminal Issues: For problems with terminal credentials, transaction processing, or account setup, contact Pelecard directly as these are handled on their end.