Author Archive

New Raise Mode Payment Workflows (Direct/Post)

Due to demand from our users, we have introduced configurable payment workflows. Each Raise Mode (KiA or AoN) can now operate in either Direct or Post payment processing mode. This is configurable behavior from the portal admin UI.

With Direct payment processing mode contribution charges get processed immediately without any delays. This also means that the project or campaign creator needs to handle refunds manually.

Post payment processing mode (a sensible default) will process all contributions after the campaign has ended. It will first pre-authorize all credit cards used for contributions and then allow for those that failed to be re-tried. Additionally, it will give opportunity to the project creator to back out if success thresholds are not met. Refunds are handled automatically because if creators back out, pre-authorizations will fall off on their own. Finally, after a 5 day period those pre-authorizations will be captured if project creators did not back out.

Direct payment processing mode is preferred mode for KiA project or campaign creators. However, KiA can still be configured to use either Direct or Post payment processing mode.

Processing Webhooks

Webhooks is a feature that allows you to set callback URL’s (webhooks) for various background processing events.

For example, let’s assume you are post processing all your campaigns and you wanted to be notified of events that transpire when campaign and it’s transactions are being processed so that you could do some other post processing using such events within your own system.

Well you could accomplish that by first navigating to Administration Panel -> Webhooks -> Background Processor.

There (as depicted in screenshot below) you will see several URL’s that can be set for each type of events you want to listen for. Once set the processor will send the URL notifications automatically when there is new data available to process.

Event notification endpoints for Background Processor

  1. Process Ending Campaigns ( Endpoint URL for campaigns in ended state )
  2. Process Pre-Auth Campaigns ( Endpoint URL for campaigns in pre-auth state )
  3. Process Accepted For Capture Campaigns ( Endpoint URL for campaigns in accepted for capture state )
  4. Process Capture Campaigns ( Endpoint URL for campaigns in capture state )
  5. Process Cancelled Campaigns ( Endpoint URL for campaigns in cancelled state )

As campaigns transition through these event states appropriate callback URL’s will be invoked as set in the Administration Panel -> Webhooks -> Background Processor and your code can then execute to do something else.

The Callback URL will get JSON posted data with following main array keys.

“data” => Main Result Data
“error” => Any Processing Errors
“action” => Endpoint Action
“fingerprint” => Fingerprint or signature for the request so it can be verified

If you need to verify that requests are originating from your instance and not somewhere else then you can use fingerprint field. Simply take the fingerprint field which will come in the JSON callback request and send GET request

You can also update fingerprint by sending PUT request to the same endpoint with fingerprint and used parameter set to true or false. This marks fingerprint as used. Note that signed fingerprints auto expire after 3 weeks from when they are created. Once expired they are removed from system.

Endpoint event actions are outlined further as per below.

Action NameAction DescriptionEndpoint
process_ending_directCampaign finalized as direct charge detected#1
process_ending_preauthCampaign updated to pre-auth state, post processing detected#1
process_preauth_campaignState change on campaign#2
process_preauth_transactionPre-auth performed on transaction#2
process_accepted_capture_campaignState change on campaign#3
process_capture_campaignState change on campaign#4
process_capture_transactionCapture performed on transaction#4
process_cancelled_campaignState change on campaign#5

Event notification endpoints for Campaign

  1. Pledge Operations ( Endpoint URL for campaign pledges )
Action NameAction DescriptionEndpoint
pledge_createCreate campaign pledge#1
pledge_updateUpdate campaign pledge#1
pledge_deleteDelete campaign pledge#1

NOTE: All event actions will result in either sucess or failure as indicated by the “error” structure returned. Also consider using HTTPS callback URL’s for increased security as information will be transmitted in encrypted form.

Below is example PHP code which can be used to listen for events on your side. You can however write such code in pretty much any modern language such as Python or Ruby.

Tagged

Email Notifications and Templates

In this short tutorial, we will show how to use and adjust each email template found in the Email Notifications tab in the Administrator Dashboard.

Toggling the Email Notifications

You can toggle (using the toggle button on the right) which email notifications you want to allow. The next step will show you how to configure the message themselves.

Customizing the Email Templates

Using the built-in text editor, you can edit the content of the emails. On the top right, you’ll see the token system we’ve implemented which allows you grab details exclusive to that campaign. Just choose a value from the dropdown, and click “Insert Token”. This will insert that token in the position of your text cursor.

Check the screenshot below for the highlighted example.

To make sure this is all working correctly please make sure to switch the froala editor to the code view (using the code view button on the toolbar) and check that your token is wrapped with <tmplvar>. Wrapping it with <tmplvar> interpolates the tokens and without this there will be issues.

Please note: You can only insert <tmplvar> through the code view.

Check screenshot below for an example.

Email Notification Table

Here is a table showing when each email notification is sent (i.e. under what conditions).

Email TitleSent Condition
Campaign ApprovedWhen a campaign is approved manually
Campaign Auto ApprovedWhen a campaign is created and automatically approved ( toggle in the settings )
Campaign Cancelled By Administrator or ManagerWhen a campaign is cancelled
Campaign Currently Being FinalizedWhen a campaign is the Finalized step during Post Processing
Campaign Not ApprovedWhen a campaign is not approved
Campaign Sent For ReviewWhen a campaign is sent for review
Campaign Review SubmittedWhen a campaign is sent for review
Change Email RequestWhen an email change request is sent
Contact Form SubmitWhen the contact form has been submitted
Forgot PasswordWhen a Forgot Password request has been sent
Inline Account RegistrationWhen a new account has been registered
Campaign Pledge Direct ProcessingWhen a pledge is made to a Direct Processing campaign
Campaign Pledge Post ProcessingWhen a pledge is made to a Post Processing campaign
Pledge Processor – Campaign Capture CompletedWhen a campaign Capture process is completed
Pledge Processor – Campaign Capture StartedWhen a campaign Capture process is started
Pledge Processor – Campaign FinishedWhen a campaign has ended
Pledge Processor – Campaign Pre AuthorizationWhen a campaign has passed or failed the Pre-Authorization process
Account ReconfirmationWhen a re-confirmation email is sent to new accounts
Account RegistrationWhen a confirmation email is sent to new accounts
Campaign Stream UpdateWhen a campaign Stream is updated
Tagged

Campaign Revisions Toggle

The campaign revisions toggle is designed to allow admins and campaign managers to update the campaign while it has already started. The toggle, however, can cause issues with the campaign among other features on the website due to its complexity.

We warn anyone who decides to use this toggle and would recommend that if you run into any minor issues on the platform, to turn this toggle OFF and see if it will fix it.

Enabling alternative layouts for your crowdfunding site

Please note that when you are enabling some of these special toggles/configurations for alternative layouts in the admin dashboard that they will alter the default layout to a custom layout.

Sometimes you may think it is broken or something doesn’t look right but this is a default template to start with which will require further CSS customization to make it look the way you want it.

If you do not want this, then make sure not to use some of these special toggles and make sure they are turned off.

If you look at the screenshot below, the toggle called “Display simple verbal campaign pledge info” will toggle an alternative layout

An example below is provided when you start using the alternative layouts.

Toggle Disabled (Default layout with default styles):

Toggle Enabled (Alternative layout without custom style):

Now that you’ve seen what these toggles will do, you may require additional custom css to be added on your site to suit your theme.

Tagged

How to Enable the Advanced CrowdFunding Widget for Your Website

In this tutorial, we will show you how to enable the Advanced CrowdFunding Widget for your website portal so that you can offer it to the users of your website.

Advanced CrowdFunding Widget allows the website campaign creators to copy and paste small HTML code snippet anywhere on their website and host the campaign directly on that website.

First navigate to your CrowdFunding Website Administration Panel and click on Portal Settings. Then follow the steps below.

Step 1. Click on Website Settings: Enable the Widget

IMPORTANT: Make sure to have this setting toggled ON

Step 2. Campaign Creation: Widget Step will be added

Note the Widget tab that is added. Here you can adjust the general theme and font colors for the widget.

Step 3. Campaign Preview

A new tab for the previews will be added. You can switch between the normal campaign preview ( Website Preview ) and the new widget preview ( Widget Preview ).

To embed the widget on any website, just follow the instructions and copy/paste the small code snippet to your target website where you want the widget to show.

Tagged

Using Okta for Social Sign On

Using Okta for your Lite Tuition Social Login

Do you want your users to sign into your Lite Tuition platform via an identity provider that they may already be using such as FacebookLinkedInGoogleAppleMicrosoft, and Okta? This tutorial is going to cover how to set up Okta the SSO (Social Sign On) feature on the Lite Tuition white label platform.

Okta is the identity provider service that you will need to use in order to add the identity providers as mentioned earlier. This will be mandatory to sign up for and set up if you would like to be using the other providers to sign into the platform.

Step 1. Sign up for Okta

Go to developer.okta.com to sign up for a new account. Be sure NOT to sign up for an okta.com account as the pricing for these accounts is different and will also provide a different dashboard user interface.

Step 2. Enable the Okta feature

Log into your Lite Tuition platform as a portal admin and do the following:

Go to the admin dashboard –> Portal Settings –> Website Settings –> Social Login –> Enable Social Login.

As you can see, you will need to paste information into the fields as shown above in order to connect with Okta and enable this feature.

Step 3. Create a new application on Okta

Once you have created the developer Okta account, you will need to create a new application on Okta. Simply log into Okta and go to the admin dashboard. Next, click on Applications.

Applications option in the left menu

You can create the new application by clicking on the blue Add Application button.

Add application

You will be directed to another page. On this page, click on the blue Create New App button in order to create the new app.

Create New App

You will then need to choose the type of app that you want to create. Choose Single Page App (SPA).

Now that you have created the new app, you will need to add the correct Login/Logout URI’s. This will be your Lite Tuition Platform URL, for example, if your platform is hosted on https://platform.litetuition.com then you should add this URL.

Step 4. Add the Client ID and Okta Domain into your Lite Tuition Platform

Now that you have created a new SPA, paste both the Client ID and the Okta domain into the Lite Tuition Platform social login settings.

Application UI

First, you will need to copy the Client ID and paste it into the Atlas dashboard.

Once you have done that, you can then copy the Okta domain and paste it into the Atlas dashboard.

PLEASE NOTE that you will need to include https:// when pasting the Okta domain into the Lite Tuition dashboard.

Step 5. Create and paste the new API token

Now that you have the client ID and Okta domain added into the Lite Tuition dashboard, you will need to add the API token from Okta. To do this, go back to the Okta admin dashboard.

Click on the Security item in the left menu, then click on the API option.

Click on the Tokens tab, then click on Create Token button.

Add a name for the new token.

You will be presented with the one-time API Token. Copy this and paste it into the Lite Tuition dashboard.

PLEASE NOTE if you have a custom login URL for Okta, you will need to make sure that this custom login URL is reflected in the issuer area when going to Okta API –> Security –> API –> edit the default API (click on blue pencil icon) –> Issuer URL. If you have not created a custom URL for Okta login then this does not apply to you.

Step 6. Adding Claims

Since you are already on the API page, click on the Authorization Servers tab, then click on the edit button (blue pencil icon).

Next, click on the Claims tab, then Add Claim.

You will need to add 2 claims. The first name and the last name. Please see the below screenshots for the correct configuration.

Remember to save the claims.

Step 7. Adding groups

You will need to add the users that you would like Okta to be using for the app. In this example, we will be using everyone. Go back to the SPA app by clicking on the applications item, the left menu.

Then click on the assignments tab. Here you can assign users to the app.

Choose Assign to Groups, then click on the Assign button to assign everyone.

That’s it! You have now connected Okta to your platform.

Now that you have followed the above steps and have successfully connected Okta to your platform, you can try adding one of the following identity providers:

Tagged

How to Setup and Configure Stripe account for your Crowdfunding portal

In this tutorial, we will cover how to set up your stripe account and connect it to your crowdfunding site.

Step 1: Create a Stripe account

Stripe Signup Page

Step 2: After logging in, access your API Keys

Go to the Stripe Dashboard and click on the Developers option at the top right corner of the page.

Stripe API Keys

You will see a set of keys. To switch between TEST  and LIVE keys, toggle the “Viewing test data” on the side. TEST keys are used for testing (Test Secret Key and Test Publishable Key) and the other for the actual live transactions (Live Secret Key and Live Publishable Key).

Note: If you want to use live data you have to make sure that you have activated your account. You will need to also fill out a form to connect your bank account.

Step 3: Copy and paste your API keys to your crowdfunding platform. It is located under Administrator Dashboard > Portal Settings > Payment Settings tab > Secret/Publishable key fields.

Step 4: Go back to your Stripe dashboard, add a redirect URI and copy/paste your Client ID to your platform.

Click on Connect Settings

Click on the gear icon in the top right corner of the screen. In the Stripe admin dashboard, then scroll down and click on the connect settings. Make sure you turn the OAuth for Standard accounts setting ON.

Copy the Redirect URL that is shown in the payment settings page:

Redirect URL Stripe Dashboard

Also, don’t forget to copy your Client ID and paste it back to your crowdfunding platform’s payment settings as shown on the screenshot below.

Once these steps are done you are all set and ready to go!

Tagged

How to set up and configure PayPal for your CrowdFunding platform

Do you want to use PayPal to accept payments on your CrowdFunding platform? If so, this tutorial will show you how to set up and configure PayPal payment gateway for your CrowdFunding instance.

PLEASE NOTE that currently you are not able to use marketplace mode when configuring the platform to be using PayPal as the payment gateway. This means that all of the donations on the platform are going into one single PayPal account. If you would like to use marketplace mode, please read this blog article.

Let’s get right into the steps!

Step 1. Go to the payment settings and choose PayPal in the dropdown

Log into your platform as a portal admin and go to the admin dashboard –> Portal Settings –> Payment Settings –> in the Payment Gateway section, choose PayPal in the dropdown.

Payment Gateway Section in Payment Settings

Step 2. Create the PayPal account

In this configuration, you will need to use a Business PayPal account to connect your account to the platform.

For this tutorial, we will be using a sandbox account in order to test the transactions without using any real money. You can also create a sandbox account if you would like to test the payments first before using a live account. You can create a sandbox account using the following URL: https://developer.paypal.com/

Step 3. Retrieve and paste the Client ID and Secret Key

Once you have created an account, you can log in and go to the accounts page. You will want to view the details for the account. Hover over the 3 dots and click on View/edit account.

Business Account

Go to the API Credentials tab for the account, then click on the Default Application link.

Click on the Default Application link

Here, you can see the Client ID and Secret Key to add in the Payment Settings in the Atlas admin dashboard.

Client ID and Secret Key

You can paste these values into the correct fields.

Step 4. Save the settings and test the payments

You can now save the Payment Settings in the admin dashboard and create a new campaign to test the transactions on the platform. When contributing, the user interface should look something like this.

If you are using a test account, you can only pledge using one of the sandbox accounts that you have. So you can go back to the accounts interface that you navigated to earlier in step 3, and click the View/edit account link for the account that you want to pledge with. If you would like, you can also create a new account to pledge with on that same page. When you click on the View/edit account button, you will see there is a Funding tab. In this funding tab, you can see the credit card information to add when making a test pledge.

Once you have made a successful pledge, be sure to check that the pledge has been captured into the correct account.

You will need to log into the account that is connected to the platform via the following link if you are testing: https://www.sandbox.paypal.com/

You should see that the pledge has been captured successfully.

PLEASE NOTE that you cannot use post charge with PayPal, so you will be capturing all donations instantly, without delays, into your PayPal account as soon as the donor makes a pledge.

That’s it, you can now accept donations via PayPal!

Tagged

Portal Admin – Administration Dashboard Tutorial

This blog post will teach you about some the functionality and provide an overview of how to use the Administrator Dashboard.

  • Once you have logged in as Portal Admin you can click on the icon in the top right corner.  This will open up the My Dashboard menu, click on Administration.
  • Once you have entered the Administrator Dashboard you will see several tabs near the top of the page, the first being Reports.

 Users

In the Users tab you can view all of the users that have accounts on your site.

  • You can filter through users by clicking on and selecting an option from either of the two drop down menus or search by name or email on the far right.
  • To add a user click on the Actions button and then select Add User from the drop down menu.  An Add User form will pop up, fill it out with the new user’s information.
  • To delete or approve a user you can click on the user’s check box on the left and then click on the Actions button. Select Delete Users or Approve Users from the drop down menu.
  • Click on the Edit button on the far right to update a particular user’s information.
  • Click on the Export to CSV button at the bottom of the page to download a spreadsheet list of all users.

Categories

In the Categories tab you can view all of the categories on your site.

  • To add a category click on the Add New Category button and fill out the form that pops up.
  • To delete a category click in the check box beside the categories that you would like to delete, and then click the Delete Selected Categories button.
  • Click on the Edit button on the far right to update the name and description of any particular category.
  • You can change the order in which categories appear by clicking and holding down on a particular category row, drag and drop it into the appropriate place in the list.

Campaigns

In the Campaigns tab you can view all of the campaigns that are on your site.

  • You can filter through campaigns by clicking on and selecting an option from any of the three drop down menus or search by the campaign name on the far right.
  • The Actions button has a few options for updating any particular campaign, (Approve CampaignDelete CampaignFeature Campaign, etc.).  Click on the campaign’s check box on the left and then click on the Actions button. Select one of the options from the drop down menu.
  • You can change the order in which campaigns appear by clicking and holding down on a particular campaign row, drag and drop it into the appropriate place in the list.
  • In the table under the Action column you can select Edit from the drop down. This will bring you to the Campaign Basics page. From here you can view and update the selected campaign’s Details, Rewards, Profile, Funding and Preview.  This blog post explains how to create or edit a campaign: Create a Campaign Tutorial.
  • Click on the Transactions button on the far right to view a breakdown of funding transactions for a particular campaign.  Click on the Export to CSV button at the bottom of the page to download a spreadsheet list of all transactions.

Pages

In the Pages tab you can view a list of the website pages that are on your site.

  • To add a page you can click on the Actions button and then select Add Page from the drop down menu.  An Add Page form will pop up.  Fill out the input fields and add content below.  Click the Save Page button once you are done editing.
  • To publish, un-publish or delete pages click on the user’s check box on the left and then click on the Actions button. Select Publish PagesUn-publish Pages or Delete Pages from the drop down menu.
  • Click on a link in the Path column to view the page. Click Edit on the right to update a page.

 Portal Settings

Portal Settings is the last tab in the Administrator Dashboard. We will cover Portal Settings in the separate blog post: Portal Admin – Portal Settings Tutorial.

Tagged