Skip to main content

Stripe Connector

Stripe Stripe is a payment processing platform for online businesses. The Stripe component provides functionality for interacting with the Stripe API, including managing customers, payment intents, charges, invoices, products, prices, subscriptions, checkout sessions, disputes, and webhooks.

API Documentation

This component was built using the Stripe REST API Reference.

Connections

API Key

Authenticate requests to Stripe using an API key.

To authenticate requests with Stripe, an API key is required. API keys are managed in the Stripe Dashboard. For background, refer to the Stripe authentication documentation.

Prerequisites

Setup Steps

  1. Sign in to the Stripe Dashboard and navigate to Developers > API keys
  2. Locate the desired secret key:
    • Use a test mode key (prefix sk_test_) for development and testing
    • Use a live mode key (prefix sk_live_) for production traffic
  3. Click Reveal test key (or create a new restricted key as needed) and copy the key value
Security Note

Secret API keys grant full access to the Stripe account. Store them securely and never expose them in client-side code or version control.

Configure the Connection

  • Enter the secret key value into the API Key field

Verify Connection

Save the integration and run any Stripe action (such as List Customers) to confirm that the API key is valid.

InputCommentsDefault
API KeyThe Stripe API Key from the Stripe Dashboard. Use a test key (sk_test_...) for development and a live key (sk_live_...) for production. Find the API key in the Stripe API keys dashboard.

Triggers

New and Updated Records

Checks for new and updated records in Stripe on a configured schedule. Events with a type ending in .created are partitioned into the created bucket; all other event types (such as .updated, .deleted, or .succeeded) are partitioned into the updated bucket.

InputCommentsDefault
ConnectionThe Stripe connection to use.
Event TypesStripe event types to poll for (e.g., customer.created, invoice.paid). Leave empty to include all event types. See Stripe event types.
Show New RecordsWhen enabled, events with type ending in .created are emitted in the created bucket of the payload.true
Show Updated RecordsWhen enabled, all other change events (e.g., .updated, .deleted, .succeeded) are emitted in the updated bucket of the payload.true

Webhook (Deprecated)

Receive and validate webhook requests from Stripe for webhooks you configure.

Webhook Events

Receive event notifications from Stripe. Automatically creates and manages a webhook subscription for the selected events when the instance is deployed, and removes the subscription when the instance is deleted. Incoming webhook signatures are validated by default.

InputCommentsDefault
Webhook EventsFor each item, provide a string value representing the event type to track. For more information, see Stripe event types.
ConnectionThe Stripe connection to use.
Disable Webhook ValidationWhen true, webhook signature validation will be skipped. This is useful for manually testing the trigger without needing a signed request.false

Actions

Attach Card

Attach a card to a customer.

InputCommentsDefault
Payment Method IDThe unique identifier for the payment method.
Customer IDThe unique identifier for the customer.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Cancel Payment Intent

Cancel a payment intent. A payment intent can be canceled when it is in one of these statuses: requires_payment_method, requires_capture, requires_confirmation, requires_action, or, in rare cases, processing.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Payment Intent IDThe unique identifier for the Payment Intent.
Cancellation ReasonThe reason for cancelling the Payment Intent.

Capture Payment Intent

Capture the funds of an existing uncaptured payment intent when its status is requires_capture.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Payment Intent IDThe unique identifier for the Payment Intent.
Amount to CaptureThe amount to capture from the PaymentIntent, which must be less than or equal to the original amount.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Application Fee AmountThe amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner’s Stripe account.
Statement DescriptorFor non-card charges, the complete description that appears on customer statements. Must be 5-22 characters and cannot use special characters <, >, \, ', ".
Statement Descriptor SuffixInformation about a card payment that customers see on their statements, concatenated with the prefix (the account name) to form the full statement descriptor.
Transfer DataThe parameters used to automatically create a Transfer when the payment is captured.

Close Dispute

Close a dispute for a charge. Closing a dispute indicates that no evidence will be submitted and acknowledges the dispute as lost.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Dispute IDThe unique identifier for the dispute.

Confirm Payment Intent

Confirm that the customer intends to pay with the current or provided payment method.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Payment Intent IDThe unique identifier for the Payment Intent.
Payment MethodID of the payment method (a PaymentMethod, Card, or compatible Source object) to attach to this PaymentIntent.
Receipt EmailThe email address that the receipt for the charge will be sent to. Updating this field triggers a new email receipt to the updated address.
Setup Future UsageIndicates the intent to make future payments with this PaymentIntent's payment method. Use on_session if the customer is present during the future payment, or off_session if not.
Capture MethodControls when the funds will be captured from the customer's account.
Error On Requires ActionSet to true to fail the payment attempt if the PaymentIntent transitions into requires_action.
MandateID of the mandate to be used for this payment.
Mandate DataThis hash contains details about the Mandate to create.
Off SessionSet to true to indicate that the customer is not in the checkout flow during this payment attempt and is therefore unable to authenticate.
Payment Method DataIf provided, this hash will be used to create a PaymentMethod.
Payment Method OptionsPayment-method-specific configuration for this PaymentIntent.
Radar OptionsOptions to configure Radar.
Return URLThe URL to redirect the customer back to after authenticating or cancelling payment on the payment method's app or site.
Use Stripe SDKSet to true when confirming server-side and using Stripe.js, iOS, or Android client-side SDKs to handle the next actions.

Create Card

Create a new card for a customer.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
Card NumberThe full credit or debit card number, with no spaces or dashes.
Expiration MonthThe two-digit expiration month of the card (01-12).
Expiration YearThe four-digit expiration year of the card.
CVCThe card security code printed on the back of the card.
Billing Street AddressThe street address for the billing information.
Billing Address 2Additional address information for the billing address (optional).
Billing CityThe city for the billing address.
Billing CountryThe two-letter ISO country code for the billing address.
Billing Postal CodeThe postal code for the billing address.
Billing StateThe state or province code for the billing address.
Billing EmailThe email address for the billing contact.
Full NameThe full name for the billing contact.
Billing PhoneThe phone number for the billing contact.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Create Checkout Session

Create a new Stripe Checkout session.

InputCommentsDefault
ModeThe behavior of the Checkout Session: payment for one-time charges, setup to collect a payment method for future use, or subscription for recurring billing.payment
Line ItemsJSON array of line items to be purchased.
EmailThe email of the customer to create the checkout session for.
Customer IDThe ID of the customer to create the checkout session for.
Client Reference IDA unique string to reference the Checkout Session. This can be a customer ID, a cart ID, or similar, and can be used to reconcile the session with your internal systems.
Success URLThe URL the customer will be directed to after the payment is successful.
Cancel URLThe URL the customer will be directed to if they decide to cancel payment.
Body ParamsMore parameters to pass to the request.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Create Customer

Create a new customer.

InputCommentsDefault
NameThe customer's full name, displayed in the Stripe Dashboard and on receipts.
PhoneThe customer's phone number in E.164 format. Used for SMS receipts and Strong Customer Authentication.
Address Line 1The first line of the customer's billing address, typically the street number and name.
Address Line 2The second line of the customer's billing address, used for apartment, suite, or unit numbers.
CityThe city portion of the customer's billing address.
CountryThe two-letter ISO 3166-1 alpha-2 country code for the customer's billing address.
Postal CodeThe postal or ZIP code portion of the customer's billing address.
StateThe state, province, or region code for the customer's billing address (e.g., CA for California).
BalanceThe starting balance of the customer in cents (e.g., 5000 = $50.00).
Default Payment Method IDThe unique identifier of the customer's default payment method.
DescriptionAn arbitrary description of the customer for internal reference.
EmailThe customer's email address. Used for receipts, invoices, and other Stripe communications.
MetadataSet of key-value pairs that can be attached to the customer. This can be useful for storing additional information about the object in a structured format.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Create Invoice

Create a new invoice.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
Customer IDThe unique identifier for the customer.
Collection MethodThe method used to collect payment for the invoice.
Payment Method IDThe unique identifier for the payment method.
Auto AdvanceWhen true, Stripe will automatically attempt collection of the invoice.false
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
Subscription IDThe unique identifier for the subscription.
DescriptionAn arbitrary description for the object, displayed in the Stripe Dashboard.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Due DateThe due date of the invoice as a Unix timestamp.
ConnectionThe Stripe connection to use.

Create Payment Intent

Create a new payment intent.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
AmountAmount intended to be collected in cents (e.g., 2000 = $20.00).
CurrencyThe three-letter ISO currency code in lowercase (e.g., usd, eur, gbp).
Automatic Payment MethodsWhen enabled, the PaymentIntent will accept payment methods enabled in the Stripe Dashboard that are compatible with the PaymentIntent's other parameters.
ConfirmWhen true, attempts to confirm this PaymentIntent immediately.false
CustomerID of the Customer this PaymentIntent belongs to, if one exists.
DescriptionAn arbitrary string attached to the object. Often useful for displaying to users.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Off SessionSet to true to indicate that the customer is not in the checkout flow during this payment attempt and is therefore unable to authenticate.
Payment MethodID of the payment method (a PaymentMethod, Card, or compatible Source object) to attach to this PaymentIntent.
Receipt EmailEmail address that the receipt for the resulting payment will be sent to.
Setup Future UsageIndicates the intent to make future payments with this PaymentIntent's payment method. Use on_session if the customer is present during the future payment, or off_session if not.
ShippingShipping information for this PaymentIntent.
Statement DescriptorFor non-card charges, the complete description that appears on customer statements. Must be 5-22 characters and cannot use special characters <, >, \, ', ".
Statement Descriptor SuffixInformation about a card payment that customers see on their statements, concatenated with the prefix (the account name) to form the full statement descriptor.
Application Fee AmountThe amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner’s Stripe account.
Capture MethodControls when the funds will be captured from the customer's account.
Confirmation MethodControls how the PaymentIntent is confirmed: automatic confirms on the server immediately, manual requires explicit client-side confirmation.
Error On Requires ActionSet to true to fail the payment attempt if the PaymentIntent transitions into requires_action.
MandateID of the mandate to be used for this payment.
Mandate DataThis hash contains details about the Mandate to create.
On Behalf OfThe Stripe account ID for which these funds are intended.
Payment Method DataIf provided, this hash will be used to create a PaymentMethod.
Payment Method OptionsPayment-method-specific configuration for this PaymentIntent.
Payment Method TypesThe list of payment method types that this PaymentIntent is allowed to use.
Radar OptionsOptions to configure Radar.
Return URLThe URL to redirect the customer back to after authenticating or cancelling payment on the payment method's app or site.
Transfer DataThe parameters used to automatically create a Transfer when the payment succeeds.
Transfer GroupA string that identifies the resulting payment as part of a group.
Use Stripe SDKSet to true when confirming server-side and using Stripe.js, iOS, or Android client-side SDKs to handle the next actions.

Create Price

Create a new price.

InputCommentsDefault
Product IDThe unique identifier for the product.
CurrencyThe three-letter ISO currency code in lowercase (e.g., usd, eur, gbp).
Unit PriceThe price per unit in cents.
ActiveWhen true, the object is currently active and available on the platform.false
NicknameA brief description of the price, hidden from customers.
Recurring IntervalThe billing frequency for recurring charges.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Create Product

Create a new product.

InputCommentsDefault
Product NameThe display name shown to customers for the product.
Product TypeThe category that classifies the product.
Product URLThe URL of a publicly-accessible webpage for this product. May only be set if type=good.
ShippableWhen true, this product can be shipped (i.e., physical goods).false
ActiveWhen true, the object is currently active and available on the platform.false
DescriptionAn arbitrary description for the object, displayed in the Stripe Dashboard.
Product ImagesFor each list item, provide a URL for the image of the product.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
Product Caption(DEPRECATED) A short one-line description of the product, meant to be displayable to the customer. May only be set if type=good.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Create Subscription

Create a new subscription.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
Price IDThe unique identifier for the price.
Collection MethodThe method used to collect payment for the invoice.
QuantityThe number of units to include in the subscription.
Payment Method IDThe unique identifier for the payment method.
Cancel AtA Unix timestamp at which the subscription should cancel. If set before the current period ends, this may cause a proration if enabled.
Days Until DueThe number of days until the payment is due.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Coupon(DEPRECATED) The unique identifier of the coupon to apply to the invoice.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Create Webhook

Create a new webhook endpoint.

InputCommentsDefault
Webhook URLThe URL where webhook events will be sent.
Webhook EventsFor each item, provide a string value representing the event type to track. For more information, see Stripe event types.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Delete All Instance Webhooks

Delete all webhook endpoints associated with each flow of the current instance.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Delete Customer

Permanently delete a customer and immediately cancel any active subscriptions on the customer.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Delete Invoice

Delete an existing invoice.

InputCommentsDefault
Invoice IDThe unique identifier for the invoice.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Delete Product

Delete an existing product by ID.

InputCommentsDefault
Product IDThe unique identifier for the product.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Delete Subscription

Cancel a subscription by ID.

InputCommentsDefault
Subscription IDThe unique identifier for the subscription.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Delete Webhook

Delete a webhook endpoint by ID.

InputCommentsDefault
Webhook IDThe ID of the webhook to delete
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Detach Card

Detach a card from a customer.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
Customer IDThe unique identifier for the customer.
Payment Method IDThe unique identifier for the payment method.
ConnectionThe Stripe connection to use.

Expire Checkout Session

Expire a Stripe Checkout session.

InputCommentsDefault
Session IDThe unique identifier for the Checkout Session.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Balance Transaction

Retrieve a balance transaction by ID.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Balance Transaction IDThe unique identifier for the balance transaction.

Get Card

Retrieve the information and metadata of a card by ID.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
Customer IDThe unique identifier for the customer.
Payment Method IDThe unique identifier for the payment method.
ConnectionThe Stripe connection to use.

Get Charge

Retrieve the details of a charge that has previously been created.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Charge IDThe unique identifier for the charge.

Get Checkout Session

Retrieve a Stripe Checkout session by ID.

InputCommentsDefault
Session IDThe unique identifier for the Checkout Session.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Customer

Retrieve the information and metadata of a customer by ID.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Dispute

Retrieve a dispute by ID.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Dispute IDThe unique identifier for the dispute.

Get Invoice

Retrieve the information and metadata of an invoice by ID.

InputCommentsDefault
Invoice IDThe unique identifier for the invoice.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Payment Intent

Retrieve the details of a payment intent that has previously been created.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Payment IDThe ID of the PaymentIntent to retrieve.
Client SecretThe client secret of the PaymentIntent. Required if a publishable key is used to retrieve the source.

Get Price

Retrieve the information and metadata of a price by ID.

InputCommentsDefault
Price IDThe unique identifier for the price.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Product

Retrieve the information and metadata of a product by ID.

InputCommentsDefault
Product IDThe unique identifier for the product.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Subscription

Retrieve the information and metadata of a subscription by ID.

InputCommentsDefault
Subscription IDThe unique identifier for the subscription.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Get Webhook

Retrieve a webhook endpoint by ID.

InputCommentsDefault
Webhook IDThe unique identifier for the webhook.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

List Accounts

Return a list of accounts connected to your platform.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Balance Transactions

Return a list of transactions that have contributed to the Stripe account balance (such as charges, transfers, and so forth).

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
CreatedA filter on the list based on the object created field.
CurrencyOnly return transactions in a certain currency. Three-letter ISO currency code, in lowercase. Must be a supported currency.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.
LimitThe maximum number of results to return.
SourceFilters results to only include transactions originating from the specified Stripe source ID (e.g., a charge or payout ID).
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Cards

Return a list of cards for a customer.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
Customer IDThe unique identifier for the customer.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
LimitThe maximum number of results to return.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.
ConnectionThe Stripe connection to use.

List Charges

Return a list of all charges.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Checkout Session Line Items

Return a list of line items for a Stripe Checkout session.

InputCommentsDefault
Session IDThe unique identifier for the Checkout Session.
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

List Checkout Sessions

Return a list of Stripe Checkout sessions.

InputCommentsDefault
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

List Customers

Return a list of customers.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Disputes

Return a list of disputes.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ChargeOnly return disputes associated to the charge specified by this charge ID.
Payment IntentFilters results to only charges created by the specified Payment Intent. Provide the Payment Intent ID to scope the query.
CreatedA filter on the list based on the object created field.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.

List Invoices

Return a list of invoices.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Payment Intents

Return a list of payment intents.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
CustomerOnly return PaymentIntents for the customer specified by this customer ID.
CreatedA filter on the list based on the object created field.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.

List Prices

Return a list of all available prices.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Products

Return a list of products.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Subscriptions

Return a list of subscriptions.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
ConnectionThe Stripe connection to use.

List Webhooks

Return a list of all webhook endpoints.

InputCommentsDefault
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
LimitThe maximum number of results to return.
Starting AfterA cursor for use in pagination. starting_after is an object ID that defines the place in the list. For instance, if a list request returns 100 objects ending with obj_foo, the next call can include starting_after=obj_foo to fetch the next page of the list.
Ending BeforeA cursor for use in pagination. ending_before is an object ID that defines the place in the list. For instance, if a list request returns 100 objects starting with obj_bar, the next call can include ending_before=obj_bar to fetch the previous page of the list.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Raw Request

Send a raw HTTP request to the Stripe API.

InputCommentsDefault
ConnectionThe Stripe connection to use.
URLInput the path only (/products), The base URL is already included (https://api.stripe.com/v1). For example, to connect to https://api.stripe.com/v1/products, only /products is entered in this field.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Debug RequestEnabling this flag will log out the current request.false
Retry Delay (ms)The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.false
Max Retry CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.false

Search Charges

Search for charges previously created using Stripe's Search Query Language.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
QueryThe search query string used to filter results. Supports Stripe's search query language with field-based filters and operators.
LimitA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
PageA cursor for pagination across multiple pages of results. Leave empty on the first call. Use the next_page value returned in a previous response to request subsequent results.

Search Payment Intents

Search for payment intents previously created using Stripe's Search Query Language.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
QueryThe search query string used to filter results. Supports Stripe's search query language with field-based filters and operators.
LimitThe maximum number of results to return.
PageA cursor for pagination across multiple pages of results. Leave empty on the first call. Use the next_page value returned in a previous response to request subsequent results.

Update Card

Update an existing card by ID.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
Card NumberThe full credit or debit card number, with no spaces or dashes.
Expiration MonthThe two-digit expiration month of the card (01-12).
Expiration YearThe four-digit expiration year of the card.
CVCThe card security code printed on the back of the card.
Billing Street AddressThe street address for the billing information.
Billing Address 2Additional address information for the billing address (optional).
Billing CityThe city for the billing address.
Billing CountryThe two-letter ISO country code for the billing address.
Billing Postal CodeThe postal code for the billing address.
Billing StateThe state or province code for the billing address.
Billing EmailThe email address for the billing contact.
Full NameThe full name for the billing contact.
Billing PhoneThe phone number for the billing contact.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
ConnectionThe Stripe connection to use.
TimeoutThe maximum time a client will await a response (in milliseconds).

Update Charge

Update a specified charge by setting the values of the parameters passed.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Charge IDThe unique identifier for the charge.
CustomerThe ID of an existing customer that will be associated with this request.
DescriptionAn arbitrary string which you can attach to a charge object. It is displayed when in the web interface alongside the charge
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Receipt EmailThe email address that the receipt for the charge will be sent to. Updating this field triggers a new email receipt to the updated address.
ShippingShipping information for the charge. Helps prevent fraud on charges for physical goods.
Fraud DetailsA set of key-value pairs you can attach to a charge giving information about its riskiness.
Transfer GroupA string that identifies this transaction as part of a group. Used with Stripe Connect to associate related charges, transfers, and refunds.

Update Checkout Session

Update an existing Stripe Checkout session.

InputCommentsDefault
Session IDThe unique identifier for the Checkout Session.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Update Customer

Update an existing customer.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
NameThe customer's full name, displayed in the Stripe Dashboard and on receipts.
PhoneThe customer's phone number in E.164 format. Used for SMS receipts and Strong Customer Authentication.
Address Line 1The first line of the customer's billing address, typically the street number and name.
Address Line 2The second line of the customer's billing address, used for apartment, suite, or unit numbers.
CityThe city portion of the customer's billing address.
CountryThe two-letter ISO 3166-1 alpha-2 country code for the customer's billing address.
Postal CodeThe postal or ZIP code portion of the customer's billing address.
StateThe state, province, or region code for the customer's billing address (e.g., CA for California).
BalanceThe starting balance of the customer in cents (e.g., 5000 = $50.00).
DescriptionAn arbitrary description of the customer for internal reference.
EmailThe customer's email address. Used for receipts, invoices, and other Stripe communications.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
MetadataSet of key-value pairs that can be attached to the customer. This can be useful for storing additional information about the object in a structured format.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Update Dispute

Update a dispute by submitting evidence or metadata. Use this action to provide evidence that helps Stripe resolve the dispute in the merchant's favor.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
Dispute IDThe unique identifier for the dispute.
EvidenceEvidence to upload to respond to a dispute.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
SubmitWhether to immediately submit evidence to the bank.

Update Invoice

Update an existing invoice.

InputCommentsDefault
Invoice IDThe unique identifier for the invoice.
Customer IDThe unique identifier for the customer.
Payment Method IDThe unique identifier for the payment method.
Auto AdvanceWhen true, Stripe will automatically attempt collection of the invoice.false
Application Fee AmountThe application fee amount in cents. Only applicable when collection method is 'Charge Automatically'.
Collection MethodThe method used to collect payment for the invoice.
CouponThe unique identifier of the coupon to apply to the invoice.
DiscountThe discount ID to apply to the invoice.
DescriptionAn arbitrary description for the object, displayed in the Stripe Dashboard.
Due DateThe due date of the invoice as a Unix timestamp.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Update Payment Intent

Update properties on a payment intent without confirming.

InputCommentsDefault
Payment Intent IDThe unique identifier for the Payment Intent.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.
AmountAmount intended to be collected in cents (e.g., 2000 = $20.00).
CurrencyThe three-letter ISO currency code in lowercase (e.g., usd, eur, gbp).
CustomerID of the Customer this PaymentIntent belongs to, if one exists.
DescriptionAn arbitrary string attached to the object. Often useful for displaying to users.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Payment MethodID of the payment method (a PaymentMethod, Card, or compatible Source object) to attach to this PaymentIntent.
Receipt EmailEmail address that the receipt for the resulting payment will be sent to.
Setup Future UsageIndicates the intent to make future payments with this PaymentIntent's payment method. Use on_session if the customer is present during the future payment, or off_session if not.
ShippingShipping information for this PaymentIntent.
Statement DescriptorFor non-card charges, the complete description that appears on customer statements. Must be 5-22 characters and cannot use special characters <, >, \, ', ".
Statement Descriptor SuffixInformation about a card payment that customers see on their statements, concatenated with the prefix (the account name) to form the full statement descriptor.
Application Fee AmountThe amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner’s Stripe account.
Capture MethodControls when the funds will be captured from the customer's account.
Payment Method DataIf provided, this hash will be used to create a PaymentMethod.
Payment Method OptionsPayment-method-specific configuration for this PaymentIntent.
Payment Method TypesThe list of payment method types that this PaymentIntent is allowed to use.
Transfer DataThe parameters used to automatically create a Transfer when the payment succeeds.
Transfer GroupA string that identifies the resulting payment as part of a group.

Update Price

Update an existing price by ID.

InputCommentsDefault
Price IDThe unique identifier for the price.
ActiveWhen true, the object is currently active and available on the platform.false
NicknameA brief description of the price, hidden from customers.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Update Product

Update an existing product.

InputCommentsDefault
Product IDThe unique identifier for the product.
Product NameThe display name shown to customers for the product.
Product URLThe URL of a publicly-accessible webpage for this product. May only be set if type=good.
ShippableWhen true, this product can be shipped (i.e., physical goods).false
ActiveWhen true, the object is currently active and available on the platform.false
DescriptionAn arbitrary description for the object, displayed in the Stripe Dashboard.
Product ImagesFor each list item, provide a URL for the image of the product.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
Product Caption(DEPRECATED) A short one-line description of the product, meant to be displayable to the customer. May only be set if type=good.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Update Subscription

Update an existing subscription.

InputCommentsDefault
Subscription IDThe unique identifier for the subscription.
Price IDThe unique identifier for the price.
QuantityThe number of units to include in the subscription.
Collection MethodThe method used to collect payment for the invoice.
Cancel AtA Unix timestamp at which the subscription should cancel. If set before the current period ends, this may cause a proration if enabled.
ValuesThe names of optional fields and their values to use when creating/updating a record. For example, if a custom configured field is not represented as an input, here its key can be specified along with an assigned value.
MetadataSet of key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them.
Coupon(DEPRECATED) The unique identifier of the coupon to apply to the invoice.
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.

Update Webhook

Update an existing webhook endpoint by ID.

InputCommentsDefault
Webhook IDThe ID of the webhook to update
Webhook URLThe URL the webhook will send requests to
Webhook EventsThe events the webhook will listen for
TimeoutThe maximum time a client will await a response (in milliseconds).
ConnectionThe Stripe connection to use.