=== PaymentSpring for Gravity Forms ===
Contributors: paymentspring
Tags: payments, credit cards, gravity forms, payment spring
Requires at least: 4.7
Tested up to: 4.8
Stable tag: 2.2.2
License: GPLv2

PaymentSpring is a credit card processing gateway with a developer friendly API. Plugin for Gravity Forms.

== Description ==
[PaymentSpring](https://www.paymentspring.com/) is a credit card processing gateway with a developer friendly API. This plugin is officially supported by PaymentSpring and is specifically designed for use with Gravity Forms.

PaymentSpring API keys are required.  You can obtain your own by [registering for a free PaymentSpring test account](https://www.paymentspring.com/signup).

= Adding PaymentSpring to your forms =

= Add the Credit Card field =

When editing or creating a form, drag and drop "Credit Card" from the "Pricing Fields" section. 

![](readme_images/credit-card-field.png)

Once dropped in, be sure to check "Use with PaymentSpring?" under the "General" tab.

![](readme_images/use-with-paymentspring.png)

You'll now need to specifiy the amount to charge a customer. There's three ways of accomplishing this.

***

= Single Product =

To charge for a single product, drag and drop a "Product" field.

##### With Quantity

By default, the product field will allow a customer to add in a quantity. 

To hook this up with the Credit Card, set "Amount" to be the field's price and "Quantity" to be the field's quantity.

![](readme_images/credit-card-config-with-quantity.png)

##### Without Quantity

To simply charge a customer, drag and drop in a "Product" field. This time, change "Field Type" to "Hidden."

![](readme_images/without-quantity.png)

The credit card configuration is almost the exact same as the previous step, just don't specific a "Quantity."

***

= Plans =

Using plans takes a couple of steps. 

Because we need to create a customer within PaymentSpring, we need to collect their personal information. 

1. Drag and Drop a "Name" field and an "Address" field from the sidebar. Both of these are found under "Advanced Fields" on the sidebar.
2. Drag and Drop a "Drop Down" field. This will be used to pick a plan.
3. Within the "Choices" we'll need to add in our available plans. Click "Bulk Add/Predifined Choices": ![](readme_images/default-choices.png).     
4. At the top of the left sidebar click "PaymentSpring Plans". **Don't change anything here.** Click "Insert Choices." ![](readme_images/predefined-choices.png)
5. Now all of your fields are ready to be hooked up to your Credit Card form. It should look something like this: 

  ![](readme_images/credit-card-with-plans.png)


##### Allow One-Time Charges

Adding a "One Time Charge" field just involves one extra step. 

Add a checkbox field like this:

![](readme_images/single-charge-field.png)

Your "Label" can be whatever you want, this is what the users will see. Just make sure the "Value" is set to "True"

Then set your Credit Card field accordingly:

![](readme_images/credit-card-with-plans-single-charge.png)

== Installation ==
1. Install Gravity Forms
2. Install the PaymentSpring for GravityForms Plugin
3. Add your API Keys (Select "Forms" on the sidebar > "Settings" > "PaymentSpring")



== Changelog ==
= 2.2.2 =
Adds a setting to send receipts on purchase.
= 2.2.1 =
Minor fix for deployment to Wordpress.
= 2.2.0 =
Adds ability to just create a customer.
= 2.1.3 =
Bug fix regarding description in Payment Spring dashboard.
= 2.1.2 =
Fixed issue with adding company and email address info to charges.
= 2.1.1 =
Add setting for toggling whether a customer is automatically created on one-time charges.
= 2.1.0 =
Customers created for one-time charges.
= 2.0.3 =
Fixes error with emails not sending.
= 2.0.1 =
Fixes error with non-PaymentSpring forms not submitting.
= 2.0.0 =
Version 2 adds the ability to subscribe to plans.