Skip to main content

Stripe Integration with Orkes Conductor

Available since
  • v5.3.0 and later

Integrating Stripe with Orkes Conductor lets you build workflows that interact with your Stripe using the following operations:

  • Get Balance
  • List Customers
  • Create Customer
  • Get Customer
  • Update Customer
  • Delete Customer
  • Create Coupon
  • List Coupons
  • Create Payment Intent
  • Get Payment Intent
  • Cancel Payment Intent
  • List Charges
  • Create Charge
  • Update Charge
  • Get Charge
  • Create Refund
  • Get Refund
  • Attach Payment Method
  • Get Payment Method
  • Detach Payment Method
  • Create Meter Event

This guide explains how to set up and use the integration. Here's an overview:

  1. Get the required credentials from Stripe.
  2. Configure a new Stripe integration in Orkes Conductor.
  3. Use Stripe integration in workflows.

Step 1: Get the Stripe credentials

To integrate Stripe with Orkes Conductor, get the API key from Stripe.

To get the API key:

  1. Log in to Stripe.
  2. Select the settings icon on the top-right.
  3. Go to Developers > API keys.
  4. Copy the Secret key (starts with sk_test_ for test mode or sk_live_ for live mode).

For testing, use the test mode API keys and for production use the live mode keys.

Step 2: Add an integration for Stripe

After obtaining the credentials, add a Stripe integration to your Conductor cluster.

To create an integration:

  1. Go to Integrations > Connected Apps from the left navigation menu on your Conductor cluster.
  2. Select + New integration.
  3. In the Payment section, choose Stripe.
  4. Select + Add and enter the following parameters:
ParameterDescriptionRequired/Optional
Integration nameA name for the integration.Required.
API KeyThe API key retrieved from Stripe in Step 1.Required.
API EndpointThe stripe API endpoint. Defaults to https://api.stripe.com.Required.
DescriptionA description of the integration.Required.

Stripe Integration with Orkes Conductor

  1. (Optional) Toggle the Active button off if you don't want to activate the integration instantly.
  2. Select Save.

Step 3: Use Stripe integration in workflows

Once the integration is ready, this can be used directly within the workflows.

To use Stripe integration in a workflow:

  1. Go to Definitions > Workflow from the left navigation menu on your Conductor cluster.
  2. Select + Define workflow.
  3. In your workflow, select the (+) icon and select Connected Apps.

Adding Stripe Integration in Conductor workflow

  1. In Add Task panel on the right, search for Stripe, and select the integration created in Step 2.

The following operations are available for use with this integration.

OperationDescription
Get BalanceRetrieves the current balance for your Stripe account, including available and pending amounts across all currencies.
List CustomersRetrieves a list of customers from your Stripe account.
Create CustomerCreates a new customer record in Stripe.
Get CustomerRetrieves the details of an existing Stripe customer.
Update CustomerUpdates an existing customer record in Stripe.
Delete CustomerDeletes an existing customer record from Stripe.
Create CouponCreates a new coupon in Stripe.
List CouponsRetrieves a list of coupons from your Stripe account.
Create Payment IntentCreates a new payment intent in Stripe.
Get Payment IntentRetrieves the details of an existing Stripe payment intent.
Cancel Payment IntentCancels an existing Stripe payment intent.
List ChargesRetrieves a list of charges from your Stripe account.
Create ChargeCreates a new charge in Stripe.
Update ChargeUpdates an existing charge in Stripe.
Get ChargeRetrieves the details of an existing Stripe charge.
Create RefundCreates a refund for an existing Stripe charge.
Get RefundRetrieves the details of an existing Stripe refund.
Attach Payment MethodAttaches a payment method to an existing Stripe customer.
Get Payment MethodRetrieves the details of an existing Stripe payment method.
Detach Payment MethodDetaches a payment method from a Stripe customer.
Create Meter EventCreates a meter event to record usage in Stripe.
  1. Select the required operation, configure the parameters, and select Save > Confirm.
  2. Select Execute to run the workflow.

For the complete operations parameters and output reference, see Stripe Operations Reference.