Stripe

Learn how to use Stripe with Composio

Overview

SLUG

STRIPE

Description

Stripe offers online payment infrastructure, fraud prevention, and APIs enabling businesses to accept and manage payments globally

Authentication Details

api_key
stringRequired

Tools

SLUG: STRIPE_CANCEL_SUBSCRIPTION

Cancels a customer's active stripe subscription at the end of the current billing period, with options to invoice immediately for metered usage and prorate charges for unused time.

Action Parameters

cancellation_details
object
invoice_now
boolean
prorate
boolean
subscription_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_CUSTOMER

Creates a new customer in stripe, required for creating charges or subscriptions; an email is highly recommended for customer communications.

Action Parameters

address
object
description
string
email
string
name
string
phone
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_INVOICE

Creates a new draft stripe invoice for a customer; use to revise an existing invoice, bill for a specific subscription (which must belong to the customer), or apply detailed customizations.

Action Parameters

account_tax_ids
array
application_fee_amount
integer
auto_advance
boolean
automatic_tax
object
automatically_finalizes_at
integer
collection_method
string
currency
string
custom_fields
array
customer
stringRequired
days_until_due
integer
default_payment_method
string
default_source
string
default_tax_rates
array
description
string
discounts
array
due_date
integer
footer
string
from_invoice
object
issuer
object
metadata
object
number
string
on_behalf_of
string
payment_settings
object
pending_invoice_items_behavior
string
rendering
object
shipping_cost
object
shipping_details
object
statement_descriptor
string
subscription
string
transfer_data
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_PAYMENT_INTENT

Creates a stripe paymentintent to initiate and process a customer's payment; using `application fee amount` for a connected account requires the `stripe-account` header.

Action Parameters

amount
integerRequired
application_fee_amount
integer
automatic_payment_methods
object
confirm
boolean
currency
stringRequired
customer
string
description
string
metadata
object
off_session
boolean
payment_method
string
payment_method_options
object
payment_method_types
array
receipt_email
string
return_url
string
setup_future_usage
string
shipping
object
statement_descriptor
string
statement_descriptor_suffix
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_PRICE

Creates a new stripe price for a product, defining its charges (one-time or recurring) and billing scheme; requires either an existing `product` id or `product data`.

Action Parameters

active
booleanDefaults to True
billing_scheme
string
currency
stringRequired
currency_options
object
custom_unit_amount
object
lookup_key
string
metadata
object
nickname
string
product
string
product_data
object
recurring
object
tax_behavior
string
tiers
array
tiers_mode
string
transfer_lookup_key
boolean
transform_quantity
object
unit_amount
integer
unit_amount_decimal
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_PRODUCT

Creates a new product in stripe, encoding the request as `application/x-www-form-urlencoded` by flattening nested structures.

Action Parameters

active
booleanDefaults to True
custom_fields
array
default_price_data
object
description
string
id
string
images
array
marketing_features
array
metadata
object
name
stringRequired
package_dimensions
object
shippable
boolean
shipping_cost
object
statement_descriptor
string
tax_code
string
unit_label
string
url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_REFUND

Creates a full or partial refund in stripe, targeting either a specific charge id or a payment intent id.

Action Parameters

amount
integer
charge
string
metadata
object
payment_intent
string
reason
string
refund_application_fee
boolean
reverse_transfer
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_CREATE_SUBSCRIPTION

Creates a new, highly configurable subscription for an existing stripe customer, supporting multiple items, trials, discounts, and various billing/payment options.

Action Parameters

add_invoice_items
array
application_fee_percent
number
automatic_tax
object
backdate_start_date
integer
billing_cycle_anchor
integer
billing_cycle_anchor_config
object
billing_thresholds
object
cancel_at
integer
cancel_at_period_end
boolean
collection_method
stringDefaults to charge_automatically
currency
string
customer
stringRequired
days_until_due
integer
default_payment_method
string
default_source
string
default_tax_rates
array
description
string
discounts
array
invoice_settings
object
items
arrayRequired
metadata
object
off_session
boolean
on_behalf_of
string
payment_behavior
string
payment_settings
object
pending_invoice_item_interval
object
promotion_code
string
proration_behavior
string
transfer_data
object
trial_end
integer
trial_from_plan
boolean
trial_period_days
integer
trial_settings
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_DELETE_CUSTOMER

Permanently deletes an existing stripe customer; this irreversible action also cancels their active subscriptions and removes all associated data.

Action Parameters

customer_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_LIST_CUSTOMER_PAYMENT_METHODS

Retrieves a list of payment methods for a given customer, supporting type filtering and pagination.

Action Parameters

customer_id
stringRequired
ending_before
string
limit
integer
starting_after
string
type
string

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringDefaults to list
successful
booleanRequired
url
stringRequired

SLUG: STRIPE_LIST_REFUNDS

Lists stripe refunds, sorted by creation date descending (newest first), with optional filtering by charge or payment intent and pagination support.

Action Parameters

charge
string
ending_before
string
limit
integer
payment_intent
string
starting_after
string

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringRequired
successful
booleanRequired
url
stringRequired

SLUG: STRIPE_LIST_SHIPPING_RATES

Retrieves a list of stripe shipping rates, filterable by active status, creation date, and currency; useful for managing or displaying shipping options.

Action Parameters

active
boolean
created
object
currency
string
ending_before
string
limit
integer
starting_after
string

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringRequired
successful
booleanRequired
url
stringRequired

SLUG: STRIPE_LIST_TAX_RATES

Retrieves a list of tax rates, which are returned sorted by creation date in descending order.

Action Parameters

active
boolean
created
object
ending_before
string
inclusive
boolean
limit
integer
starting_after
string

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
object
stringRequired
successful
booleanRequired
url
stringRequired

SLUG: STRIPE_RETRIEVE_CHARGE

Retrieves full details for an existing stripe charge using its unique id.

Action Parameters

charge_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_RETRIEVE_PAYMENT_INTENT

Retrieves a paymentintent by its id; `client secret` is required if a publishable api key is used.

Action Parameters

client_secret
string
payment_intent_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_RETRIEVE_REFUND

Retrieves details for an existing stripe refund using its unique `refund id`.

Action Parameters

refund_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_SEARCH_CUSTOMERS

Retrieves a list of stripe customers matching a search query that adheres to stripe's search query language.

Action Parameters

limit
integer
page
string
query
stringRequired

Action Response

data
arrayRequired
error
string
has_more
booleanRequired
next_page
string
object
stringDefaults to search_result
successful
booleanRequired
url
stringRequired

SLUG: STRIPE_UPDATE_PAYMENT_INTENT

Updates a stripe paymentintent with new values for specified parameters; note that if `currency` is updated, `amount` might also be required, and certain updates (e.g., to `payment method`) can necessitate re-confirmation by the customer.

Action Parameters

amount
integer
currency
string
customer
string
description
string
metadata
object
payment_intent_id
stringRequired
payment_method
string
receipt_email
string
setup_future_usage
string
shipping
object
statement_descriptor
string
statement_descriptor_suffix
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: STRIPE_UPDATE_SUBSCRIPTION

Updates an existing, non-canceled stripe subscription by its id, ensuring all referenced entity ids (e.g., prices, coupons) are valid and automatic tax liability is correctly specified if enabled.

Action Parameters

automatic_tax
object
billing_cycle_anchor
integer
cancel_at_period_end
boolean
collection_method
string
default_payment_method
string
description
string
items
array
metadata
object
payment_behavior
string
proration_behavior
string
subscription_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired