PlugnPay Simple ARB (Automatic Recur Billing) Module

====================================================
PlugnPay Simple ARB (Automatic Recur Billing) Module
Payment Module for ZenCart v1.3.8

Last updated by plugnpay support
====================================================

***** IMPORTANT NOTES *****
This module is being provided "AS IS". Limited technical support assistance will be given to help diagnose/address problems with this module. The amount of support provided is up to PlugnPay's staff.

It is recommended if you experience a problem with this module, first seek assistance through this module's readme file, then check with the ZenCart community forum, and if you are still unable to resolve the issue, contact us via PlugnPay's Online Helpdesk.

This module requires your server to have SSL abilities & CURL. ZenCart will ask the customer for all of their credit card info on your server's SSL secured billing pages. The authorization will be done via PlugnPay's API payment method. The module is intended to itemize the order in the PlugnPay system using available information from the cart & handle any additional/future recurring payments automatically via PlugnPay's Membership Management service.

You MUST be subscribed to & setup with PlugnPay's Membership Management Service [with the Installment Billing option enabled] prior to attempting to use this payment module; as this additional PlugnPay service required to store the customer's CC information & automatically charge the remaining payments as directed.

In addition, you should have the 'Enable secure SSL/HTTPS connections' option enabled in your ZenCart shopping cart to properly use this module.
***************************

This module is designed to use PlugnPay's API payment method, via cURL.
Subscription management is handled in your merchant interface on PlugnPay, not in ZenCart.

================== I M P O R T A N T _ W A R N I N G ============================
%% YOU MUST BE SUBSCRIBED TO & SETUP WITH OUR MEMBERSHIP MANAGEMENT SERVICE, %%
%% W/INSTALLMENT BILLING OPTION ENABLED, BEFORE ATTEMPTING TO USE THIS MODULE. %%
=================================================================================

This module is intended to break-up customer's order into 2 or more payments.
-- The first payment is applied at time of the customer's purchase.
-- The balance of the order will be automatically billed via PnP's membership service.

Upon settings defined, merchant can apply the payment structure the following ways:

==_ Equal Payments - initial payment & remaining payments are all equal $ amounts.
Example: - Customer places an order for $100.
- Module is setup to pay in four payments [initial payment + 3 occurrences]
[i.e. $100 total / 4 payments = $25 per payment]
- Customer would be charged a $25 payment at time of purchase.
- The balance of the order would be $75.
[i.e. $100 total - $25 init payment = $75 balance]
- Customer would be charged $25 for the remaining 3 payments
[i.e. $75 balance / 3 remain payments = $25 per payment]

==_ Discounted Payment - initial payment discounted. Remaining balace paid in equal amounts.
Example: - Customer places an order for $100.
- Module is setup to pay in four payments [initial payment + 3 occurrences]
[i.e. $100 total / 4 payments = $25 per payment]
- Module is setup to discount $10 from initial payment
- Customer would be charged a $15 payment at time of purchase.
[i.e. ($100 total / 4 payments) - $10 discount = $15 init payment]
- The balance of the order would be $85.
[i.e. $100 total - $15 init payment = $85 balance]
- Customer would be charged $28.33 for the remaining 3 payments
[i.e. $85 balance / 3 remain payments = $28.33 per payment]

==_ No Initial Payment - no initial payment. Full amount paid in equal payments
Example: - Customer places an order for $100.
- Module is setup to pay in four payments [initial payment + 3 occurrences]
[i.e. $100 total / 4 payments = $25 per payment]
- Module is setup to skip initial payment
- Customer would be charged a $0 payment at time of purchase.
- The balance of the order would be $100.
[i.e. $100 total - $0 init payment = $100 balance]
- Customer would be charged $33.33 for the remaining 3 payments
[i.e. $100 balance / 3 remain payments = $33.33 per payment]
(* Note: the extra penny is automatically applied to last payment.)