Step by Step – Add Stripe Payments

Stripe is a US-based online payment company which provides credit card solutions in 30+ countries around the world (including Australia and New Zealand). As an event organiser using Director, a Stripe account will allow you to receive entry fee and merchandise payments made by credit card – and authorised in real-time – without the overhead involved in setting up your own merchant account with your bank.

In New Zealand, Stripe fees are 2.9% of transaction value plus 30c. In Australia, Stripe fees are 1.75% + 30c for domestic cards and 2.9% + 30c for overseas cards.

Step 1: Setup Your Stripe Account

1. If you don’t already have a Stripe account, go to stripe.com and follow the sign up instructions.
2. Once setup, you will need to be able to access your API keys. BE CAREFUL when using Stripe to access your LIVE settings (not TEST settings).
3. Navigate to Developers -> API Keys
4. Under “Standard Keys” you should see a Publishable Key and a Secret Key. You’ll need both of these values for the next step.

Step 2: Create the Payment Method on Director

1. Go to “Stores”: menu: Payment Methods
2. Click the Add New button
   1. Name: “Stripe Payments”
   2. Button Text (the button your entrants will see) to, e.g. “Pay Online by Visa/Mastercard”
   3. Select Stripe as the payment gateway and set the settlement time to 23:59:59
   4. Make sure the Active toggle is set ON
   5. In the Account ID field, paste the Publishable Key from your stripe dashboard.
   6. In the Account Password field, paste the Secret Key from your stripe dashboard.
   7. Click the Save button
3. Your new payment method should now appear on the list. Look for the Actions button next to it and select the option “Generate Webhook”
4. In the popup window, click the Create button. A “webhook” is a backup/failsafe way of Stripe and Director communicating so that successful payments are always reflected on the Director database. You’ll only ever need to do this once and if you look on your Stripe Dashboard -> Developers -> Webhooks, you’ll see the newly created web hook there.

The payment method is now ready to use, the final step is to add it to your store.

Step 3: Add Stripe to Your Store

1. Open the Store Dashboard for the store you want to make Stripe available on.
2. The quickest way to access the Store Dashboard is to go to Stores -> My Stores and click on the Dashboard icon next to the store you want to work with.
3. Click onto the Payment Methods tab.
4. Click the Add New button
   1. Select your new Stripe Payments payment method from the list.
   2. Choose the type of transactions you want this payment method to be available for. Typically, for online/ecommerce Payment Methods, you’ll want it to be available for all transaction types so move all the sliders to the ON position.
   3. If you are planning to pass on your processing fees to your entrants as a surcharge, you can setup a surcharge here which will be applied at checkout.
   4. Click the Save button.
5. Stripe payments are not setup on your store.

Important! It is well worth creating a registration in your store and clicking the Stripe button at checkout to ensure you are directed to the Stripe payment page. This should give you comfort the payment method is operating correctly.

For Expert Users Only. Expert users may want to perform a complete end-to-end test of their registrations. To do this without making actual charges against your credit card, you can set up ANOTHER Payment Method on Director. Call it “Stripe Test” and use the test API credentials from Stripe to set it up exactly as above. Stripe provides a “magic” credit card number of 4242 4242 4242 4242 to test successful transactions using their test account credentials. Remember to withdraw any registrations created in this way and keep in mind that these registrations are billable on Director.