Stripe Marketplace Express Plugin

Demo to preview the settings

Introduction

Creating a web app pretty much always requires an integration of a payment system. These systems might be rather simple or very complex, depending on your type of app. Stripe is one of the best software platforms for that, whether you’re creating a subscription service, an on-demand marketplace, an e-commerce store, or a crowdfunding platform. Stripe’s meticulously designed APIs and unmatched functionality help you create the best possible product for your users.
Right now the solutions regarding Stripe API that are offered for Bubble users are very limited and require additional development for the functionalities you want your platform to have. Not to mention that the existing solutions are not very well optimized when it comes to developing a more complex service.
This is where we decided to create a plugin that offers pretty much all the tools for setting up a medium to high-complexity payment system with optimization and high performance in mind. You won't need to install multiple plugins or develop additional basic functionalities that other plugins are lacking.
Also, we minimized the number of action calls to the minimum for achieving a faster performance and a more clean workflow. And if you still don't find what you need don't worry we are constantly updating the plugin with new functionalities.
Stripe Marketplace is SCA -Ready plugin that comes with the SCA element token to authenticate, the online payments flow requires the use of 3D Secure for card payments.

Prerequisites

You must have an account with Stripe to interact with the Stripe API. Create your development account at https://dashboard.stripe.com/

Tutorial

Stripe Marketplace Express Plugin Tutorial
Stripe Marketplace Express Plugin Tutorial

Setup requirements

First, you will need to go to stripe.com and register an account.
After you have successfully verified your email address and activated your account, under the Activate your account tab, you can start setting up stripe features you need.
Image without caption
After that, you will need to set up the keys for the plugin. To find the keys go to your stripe dashboard and find API keys under the Developers tab. You need to copy the Publishable and Secret keys both for live and development versions.
Make sure when adding the secret keys to the plugin to add text 'Bearer' before the key (do this just for the secret key) to use it in plugin settings.
Image without caption
Also, make sure you have enabled stripe Connect (Build a platform or marketplace).
Image without caption
Once you've got the keys from Stripe dashboard, for both Live and Development versions place them in Plugins Settings Tab for the Stripe Marketplace Plugin, which should look like this:
Image without caption

Plugin calls & elements

Elements

This plugin has 2 elements:
  • One is called Stripe Marketplace Token. It is used for creating a bank account or card token.
Image without caption
Note: You just have to place the Stripe Marketplace Token on the page and call it from within the workflow when you are trying to convert a form into the token.
Using the Stripe Marketplace Token you can create:
  • a credit card token
  • a bank account token
  • PII token
Image without caption
Note: To use the token you will have to add another workflow that will run when the token is created.
Create ID Number Token Use Create ID Number Token action to convert personally identifiable information (PII) into a single-use token for account identity verification.
Fields:
Title
Description
Type
Personal ID number
The personal ID number. Example: 123131185
text
There you can use the token to create a customer and assign him a credit card, create a stripe seller, or make a payment using the token you have created.
Image without caption
Also, you can add an additional workflow that will check for errors during the token creation thus giving you the option to set up a custom solution for the users.
  • Another element is called SCA. It is primarily used to meet Strong Customer Authentication requirements when setting up the payment process.
Image without caption
Note: To use the SCA actions you will need to place the SCA element on the page.
Using the SCA you can:
  • access a previously created Session which is related to pretty much all other SCA-related action calls

Stripe Marketplace Token Action Calls

All the calls that have multiple fields to be filled in were developed to contain all the necessary parameters stripe requires. Some of them might have a lot of fields but the idea is that you can choose what you want to be filled in while leaving the others blank. This way we maximized the performance of sending requests by having at maximum only 1 being sent while still giving you to option to choose what your request will contain. Also when using an action call, check the documentation for each field it has, for a better understanding of how it works.

Create express/standard/custom account

Connect express/standard account (Deprecated)

Complete express/standard account connection

Create a seller - Individual

Update a seller - Individual

Create a seller - Company

Update a seller - Company

Create a person

Update a person

Delete a seller

Create a file

Create a customer

Update a customer

Create a card

Delete a card

Delete a bank account

Platform charge a customer (Create a charge)

Create a refund

Seller charge a customer

Link a customer to a seller

Retrieve a customer

Retrieve a seller

Retrieve all charges

Retrieve all payouts

Retrieve a seller's balance

Create a subscription

Update a subscription

Retrieve a subscription

Create dashboard link (for express accounts only!)

Retrieve all invoices

Creating separate charges and transfers

Calculate tax

Create a tax transaction from a calculation

Retrieve a tax transaction

Cancel a refund

Update a bank account

Create an account link

SCA Actions

Create a session (SCA related)

Create a session (Multiple products) (SCA related)

Creating destination charges (SCA related)

Go to checkout (SCA related)

Clone a customer's payment method (SCA related)

Attach a payment method to a customer (SCA related)

Detach a payment method from a customer (SCA related)

Create a payment intent (SCA related)

Confirm a payment intent (SCA related)

Capture a payment intent (SCA related)

Retrieve a session (SCA related)

Retrieve a setup intent (SCA related)

Retrieve a customer's payment methods (SCA related)

Retrieve all payment intents (SCA related)

Create a billing portal session (SCA related)

Data Calls

Retrieve a seller

Retrieve a customer

Retrieve all charges

Retrieve all payouts

Retrieve a setup intent

Retrieve all payment intents

Retrieve a session

Retrieve a seller's balance

Retrieve all invoices

Retrieve a customer's sources

Retrieve a customer's payment methods

Retrieve a payment intent

Retrieve all coupons

Retrieve a price/plan

Retrieve all prices

Retrieve a refund

Events

Title
Description
Card Token Created
When card token was created
Bank Account Token Created
When Bank Account Token Created was created
ID Number Token created
When ID Number Token was created
Error
When Error

States

Title
Description
Card Token
The created card token.
Bank Account Token
The created bank account token
Status code
Error Code
Error Message
The Error Message.
Error Type
Card ID
The created card id.
Client IP
IP address of the client that generated the token.
Created
Time at which the object was created. Measured in seconds since the Unix epoch.
PII Token
Creates a single-use token that represents the details of personally identifiable information (PII). This token can be used in place of an id_number in Account or Person Update API methods. A PII token can be used only once.
Livemode
Has the value true if the object exists in live mode or the value false if the object exists in test mode.
Used
Whether this token has already been used (tokens can be used only once).

Changelogs

Update 20.09.24 - Version 1.118.0

  • New action - Create checkout session(multiple products), payout schedule feature for connected accounts

Update 10.09.24 - Version 1.117.0

  • Added field 'Promo Code' and checkbox 'Automatic Tax' to "Update a subscription"

Update 10.09.24 - Version 1.116.0

  • added field 'Promo Code' and checkbox 'Automatic Tax' to "Update a subscription"

Update 09.09.24 - Version 1.115.0

  • Updated metadata in data call 'Retrieve a promotion code'

Update 09.09.24 - Version 1.114.0

  • Updated data call 'Retrieve a promotion code'

Update 21.08.24 - Version 1.113.0

  • Fixed "Create a subscription" and "Update a subscription" actions

Update 13.08.24 - Version 1.112.0

  • Updated actions 'Create a payment intent', 'Create a transfer'

Update 13.08.24 - Version 1.111.0

  • Added data calls "Retrieve and list promotion codes", fields "Promo Code & Automatic Tax" to Create a Subscription

Update 25.07.24 - Version 1.110.0

  • Minor update

Update 16.07.24 - Version 1.109.0

  • Minor update (Marketing update)

Update 08.07.24 - Version 1.108.0

  • Minor update - (a marketing update)

Update 19.06.24 - Version 1.107.0

  • Minor update

Update 13.06.24 - Version 1.106.0

  • Added "Retrieve a subscription" action

Update 06.06.24 - Version 1.104.0

  • Minor update

Update 18.05.24 - Version 1.103.0

  • Added "Payment method types" field in "Create a session" action

Update 25.03.24 - Version 1.101.0

  • Create express/standard/custom account” action

Update 02.02.24 - Version 1.100.0

  • Fixed "Update a customer" action

Update 24.01.24 - Version 1.99.0

  • Fixed "Send an invoice" action

Update 19.01.24 - Version 1.97.0

  • Fixed "Create an invoice item" action

Update 11.01.24 - Version 1.96.0

  • Fixed "Create a session" action and some api calls

Update 05.12.23 - Version 1.93.0

  • Fixed “Create an invoice” and “Create a payment intent” actions

Update 27.11.23 - Version 1.92.0

  • Added "Business tax ID" field in "Update a seller - Individual" action

Update 22.11.23 - Version 1.91.0

  • Fixed "Create a card" action call

Update 21.11.23 - Version 1.90.0

  • Fixed "Create Card Token" and "Platform charge a customer" actions

Update 20.11.23 - Version 1.89.0

  • Added “Create a bank account”, “Update a bank account” actions

Update 20.11.23 - Version 1.88.0

  • Fixed “Create a seller - Individual”, “Update a seller - Individual” actions

Update 14.09.23 - Version 1.84.0

  • Added "Owners provided" field in the "Update a seller - Company" action

Update 12.09.23 - Version 1.83.0

  • minor updates

Update 05.09.23 - Version 1.81.0

  • Added "Currency" field in "Create Card Token" action

Update 17.08.23 - Version 1.80.0

  • "Cancel a refund" acton calls and minor fixes

Update 17.08.23 - Version 1.79.0

  • Added "Retrieve a refund"

Update 10.08.23 - Version 1.78.0

  • Added a "Stripe-Account" field for the "Create a customer" action

Update 27.07.23 - Version 1.77.0

  • Internal update

Update 13.06.23 - Version 1.73.0

  • Fixed "Confirm a SetupIntent" action call

Update 09.06.23 - Version 1.72.0

  • Fixed “Create Setup Intents” and “Confirm Setup Intents”

Update 08.06.23 - Version 1.71.0

  • Added the Create, Cancel, Confirm, and List all SetupIntent API calls

Update 24.05.23 - Version 1.70.0

  • Added "Quantity" field in "Update a subscription" action

Update 08.05.23 - Version 1.69.0

  • Added "Confirm a Payment intent (3Ds2 secure)" action

Update 11.04.23 - Version 1.68.0

  • Updated "Go to checkout" action

Update 24.03.23 - Version 1.67.0

  • Minor firxes

Update 23.02.23 - Version 1.66.0

  • deleted the icons

Update 01.02.23 - Version 1.63.0

  • minor fixed

Update 23.01.23 - Version 1.62.0

  • minor edits

Update 23.01.23 - Version 1.61.0

  • Fixed "Creating destination charges" action

Update 20.01.23 - Version 1.59.0

  • Fixed "Connect express/standard account" action

Update 10.01.23 - Version 1.58.0

  • Fixed "Creating destination charges", "Go to checkout" actions

Update 03.01.23 - Version 1.57.0

  • Fixed "Creating destination charges" action

Update 19.12.22 - Version 1.56.0

  • Added "Creating destination charges" action

Update 13.11.22 - Version 1.55.0

  • Fixed "Create a transfer" action

Update 17.10.22 - Version 1.54.0

  • Added “Creating separate charges and transfers” action and fixed “Create Subscription & Update Subscription” actions

Update 06.10.22 - Version 1.52.0

  • Fixed “Create Subscription” and “Update Subscription” actions

Update 11.08.22 - Version 1.48.0

  • Added "description" field in the "Create a transfer" action.

Update 29.07.22 - Version 1.47.0

  • Fixed Error event

Update 22.06.22 - Version 1.46.0

  • Updated description

Update 09.05.22 - Version 1.44.0

  • Added text in description

Update 15.12.21 - Version 1.43.0

  • minor fixies

Update 04.10.21 - Version 1.42.0

  • Added the option to use coupons when creating a session in payment mode & other minor fixes

Update 23.09.21 - Version 1.41.0

  • Resizable and responsive were included

Update 16.09.21 - Version 1.40.0

  • Added the option to update the default payment source/method.

Update 06.09.21 - Version 1.39.0

  • Added more support for subscriptions including creating coupons and stripe subscription plans.

Update 05.08.21 - Version 1.38.0

  • Added the option to send a created invoice and to retrieve a payment intent, & minor fixes

Update 04.08.21 - Version 1.37.0

  • Added the option to send a created invoice and to retrieve a payment intent, & minor fixes

Update 02.08.21 - Version 1.36.0

  • Minor fixes

Update 30.07.21 - Version 1.35.0

  • Minor fixes

Update 30.07.21 - Version 1.34.0

  • Added the option to pay an invoice & minor fixes

Update 28.07.21 - Version 1.32.0

  • Added the option to add bank accounts to customers and verification of a bank account as well as invoices creation

Update 26.05.21 - Version 1.30.0

  • Added the option to set the tos service agreement when creating a custom account

Update 06.04.21 - Version 1.29.0

  • Added separate calls for retrieving customer's cards & payment methods

Update 15.02.21 - Version 1.26.0

  • Improvement calls with PII Token

Update 08.02.21 - Version 1.24.0

  • Improvement calls with PII Token

Update 30.10.20 - Version 1.23.0

  • Added the retrieve of invoices functionality, improved capture of payment intents, and creation of a session action call

Update 01.09.20 - Version 1.22.0

  • Updated demo page

Update 07.08.20 - Version 1.21.0

  • Fixed deprecated action calls. Added new billing portal feature and retrieve of an account's balance.

Update 14.05.20 - Version 1.19.0

  • Minor Fixes

Update 08.05.20 - Version 1.18.0

  • Minor Changes

Update 08.05.20 - Version 1.17.0

  • Fixed payouts data call and added "source_trans" to the action "transaction"

Update 28.04.20 - Version 1.16.0

  • Added the option for express accounts to access stripe's dashboard and some minor tweaks

Update 27.04.20 - Version 1.15.0

  • Made plugin SCA ready

Update 02.04.20 - Version 1.14.0

  • Added the option to make refunds and minor changes to Retrieve all charges and Retrieve all payouts data calls

Update 10.03.20 - Version 1.13.0

  • Minor fixes

Update 02.03.20 - Version 1.12.0

  • Fixed country code error for "Update a seller - Company".

Update 29.02.20 - Version 1.11.0

  • Update account - company {country code}

Update 19.02.20 - Version 1.10.0

  • What's new: Added the option to submit additional verification documents for individual accounts and persons. And some minor fixes.

Update 18.02.20 - Version 1.9.0

  • What's new: changing a customer's default source using and existing source instead of creating a new one that replaces the old default source. And some minor bug fixes.

Update 04.02.20 - Version 1.8.0

  • Added support for express/standard accounts onboarding as well as money transfers between platform and connected accounts..

Update 06.01.20 - Version 1.5.0

  • Update: added "Update seller - Company", "Update person".

Update 28.11.19 - Version 1.4.0

  • Added the ability for customer to delete their card

Update 13.11.19 - Version 1.3.0

  • Added functionality to cancel a subscription and update subscriptions with multiple items

Update 04.11.19 - Version 1.0.0

  • Initial Release
Share
Content