Skip to main content
Version: v2.0

Ledger to Stripe Payout

In this example, we're going to create a workflow that will transfer funds from a ledger account to a Stripe Connect account by leveraging the send stage.


To initiate a transfer from a ledger account to a Stripe Connect account, you must have set the formanceAccountID metadata key on the ledger account metadata to identify the formance account ID related to the Stripe Connect account to initiate the transfer to.

What's happening in this example?

Before we dive into the workflow definition, let's take a look at what's happening in this example. As you may imagine, when we say "transfer funds from a ledger account to a Stripe Connect account", we don't mean that funds are actually being teleported from our own ledger account to our Stripe Connect account balance. Instead, we'll be doing two things:

  1. Recycle the funds we previously introduced in the ledger by transferring them to the @world account
  2. Transfer the funds from our main Stripe balance to the target Stripe Connect account
Ledger transaction (top, rounded) and Stripe Connect transfer (bottom, squared)

The Flows service will be taking care of the sequencing for us.


Prior to creating and executing this workflow, you'll need to have the following:

  • The Stripe connector set up and configured with a write-able API key
  • A ledger account provisioned with funds,
  • and a formanceAccountID metadata key set on it - corresponding to the formance account related Stripe Connect account you want to transfer funds to

Workflow definition

Unceremoniously, here's the workflow definition we'll be using in this example:

name: "ledger-to-stripe-payout-demo"
- send:
id: "payouts:1234"
ledger: "flows-demo-001"
psp: "stripe"
amount: "${amount.amount}"
asset: "${amount.asset}"