Formstack

Stripe

Stripe is a credit card processor that is popular with developers. Our Stripe integration was built using the REST API v1 - 2012-07-09*.
stripe1.png

To add Stripe to your payment form, go to Settings > Integratios > Payments and click the "Add" button next to Stripe. This will add a tab under the Integrations tab where you can begin setting up the Stripe integration. stripe2.png
Click on the blue "Log in to Stripe" button. You will be taken to a Stripe website where you need to grant Formstack access to your Stripe Account, then either sign up for a Stripe account or log in to a current account. 

If a form in your account is already using the Stripe integration you can also import that integration's credentials by selecting the form from the dropdown list.

Transaction Types

Single Payment:

To set up a form for a good, service, or donation that requires only one payment choose "Single Payment" as the Transaction Type. Next, choose a currency, then whether you want to show only a single item in Stripe or an itemized list of items. The "Single Item" setting is great for when you have a Total field and if you need to use a discount code.The Multiple Items setting is great when you have many items for purchase and would like to easily see what your customers have bought. Map each item's price (and optional quantity) and give each item a label. Stripe will automatically add these items up. Discount Code fields do not work with this setup as they are applied to the "Total" field.

 

Subscription:

For purchases that require a subscription or multiple payment installments choose the "Subscription" Transaction Type. You'll need to either need to choose an existing subscription plan from your Stripe account or create a new one within the integration.
To create a new subscription plan within the integration add a Plan ID and Plan Name along with an Interval of either "Monthly" or "Yearly" and then set the Currency. The quantity is, again, optional and will default to 1 if not selected.

 Note: When sending customer information to Stripe, a customer will be created if using the Subscription mode, but not for one-time payments.

Choice:

The "Choice" transaction type will allow your users to choose whether they would like their payment to be a one-time deal or a subscription. This is a great option for donation forms. If you choose this option you'll see the same setup options as above, but all on one screen.




The main difference is you'll need a "Choice" field on the form to give your customers a choice of either a one-time payment or to start a subscription.




Add a select list or radio button field and make the options "One-Time" and "Subscription". Then add separate values of "Payment" and "Subscription" (no quotation marks).



Payment Information




Since Stripe is an on-form payment processor you must have credit card information fields on your form. These are mapped in this section. The numbers will be sanitized as they enter your database unless you click "Save in Database".



Customer Information


This section is optional. However, these fields will often automatically map if you have the corresponding fields on your form. Currently, the Email value is only sent when signing up Form Submitters for a subscription.



Error Handling


This section is also optional, but we highly recommend adding an email address in the "Email on Failure" box so you are contacted if the integration fails. Be careful when checking the "Allow Submission if Integration Fails" box as customers with incorrect credit card information will be able to submit the form successfully.

Note that there is no way to re-run Stripe or any other payment integrations through Formstack due to security reasons.

* Please note, any functionality that came after 2012-07-09 will not be able to be utilized with our integration.

Related Pages