IgnitionDeck Documentation

Stripe Connect

stripe-logo

Stripe Connect allows you, as a crowdfunding portal or e-commerce website owner, to charge a fee on top of transactions made on your site. Stripe Connect enables fees on a flat or percentage basis, and is available as part of the IgnitionDeck Enterprise package.

Users can authenticate (via oAuth) for your application by visiting their payment settings page, viewable once they have submitted a project or product for review, provided it has been enabled in the gateway settings menu.

Once you’ve set up your payment gateway(s), you will probably want to perform some test transactions to make sure everything is working properly. For some tips on testing your payments gateway(s), see our documentation page called Payment Gateway Testing.

How to Enable Stripe Connect

Stripe Connect is included as part of IgnitionDeck Enterprise. To enable, simply visit IgnitionDeck Commerce->Gateways and enable Stripe and Stripe Connect. You may not see this option if a) you have not validated your license key in the IgnitionDeck->Settings menu or b) You have another credit card payment gateway enabled.

How to Create Your Stripe Connect Application

  1. Visit your Stripe.com dashboard and click on Connect in the left side, and then Settings on the right.
  2. Create a new application by selecting Register Your Platform and use the following format for your development URL’s:
    SC_AppSettings2

    • Redirect URI: https://yourdomain.com/[your-dashboard-link]/?payment_settings=1&ipn_handler=sc_return (substitute http if using on localhost or non-SSL dev environment)
    • Use the same links for your production URL’s, but use https:// instead of http:// (SSL is required)
  3. Copy and Past the production and development client ID’s in your IgnitionDeck Commerce->Stripe Connect settings menu and save
  4. Click on the Webhooks link in the left menu, and then click Settings, and Add Endpoint for Connect:

    • Webhook URL: https://yourdomain.com/?ipn_handler=connect and select Mode: Production (this webhook can be used for both live and testing transactions)
  5. Click on the Webhook settings again and create another endpoint for Connect.  This webhook is optional for Immediate and 100% threshold types, but required if you are going to permit project creators to use the Subscription / Recurring funding type:
    • Webhook URL: http://yourdomain.com/?memberdeck_notify=stripe and select Mode: Development (you will need to update this webhook to HTTPS / Production when you go live, but for testing purposes use HTTP / Test)

How to Charge Fees with Stripe Connect

Enter your desired Fee type (percentage or flat dollar amount) and Fee amount in the Application Settings as depicted above, and save. Ensure that new project creators visit their payment settings screen and authorize with your application via Stripe Connect. When successful, they will see a checkmark icon in their Stripe Connect button with a message that says ‘Connected.’

Screen Shot 2014-02-07 at 4.59.01 PM

Going forward, all purchases made on your site, provided the creator has authorized via Stripe Connect, will be charged the fee dictated in your Stripe Connect settings. This fee is automatically deducted from the funds that are sent to the merchant’s account post-purchase and applied to your Stripe Balance.

To determine if a Project Creator has successful connected their Stripe account, go to your Stripe.com account, scroll down to Applications: Connected Accounts.  The Project Creator’s Stripe account email will appear in this list if they have successfully completed their connection:

SC_connectedAccts

Going Live

When you are ready to go live and have taken your payment gateways out of Test Mode, be sure to go to IDC > Stripe Connect and uncheck the Development Mode checkbox, otherwise your project creators will not be able to connect their live payment accounts to your testing environment:

IDE_StripeConnect_devmode

In your Stripe dashboard, update your webhooks (if you didn’t include Live configurations on your initial set up) for HTTPS / Live protocols:

  • Webhook URL: https://yourdomain.com/?memberdeck_notify=stripe and select Mode: Production
  • Webhook URL: https://yourdomain.com/?ipn_handler=connect and select Mode: Production

Stripe Connect and Subscription Funding

If your project creator is going to use the Subscription funding option on their campaign, they must set up the webhook in their Stripe account in order for the Subscription plan to be created properly within their account.  Failure to do so will result in the subscription plan being created in the site owner’s Stripe account and all funds sent to the site owner instead of the project owner.

  • Connect Webhook URL: https://yourdomain.com/?memberdeck_notify=stripe and select Mode: Production

Common Errors

No such customer or similar objects exist in live mode. But test mode key was used to make this request

This error happens when a project creator’s Stripe account has been connected during the Test mode of the payment gateway but then a payment is attempted when the gateway has been switched into Live mode.  To fix this error the project creator’s Stripe credentials must be revoked from the site so that they can reconnect in the Live mode.

  • Revoke credentials in IDC > Stripe Connect > User Management.
  • Select the user in the drop down menu and click “Revoke Credentials”.
  • The project creator can now reconnect their Stripe account in the Live mode.

stripeconnect_revokecreds