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 configured webhooks.

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
Webhook SecretThe signing secret used to verify incoming signatures. Leave empty to use the secret of the endpoint created when the instance was deployed. Supply it only when the deployment reused a pre-existing endpoint, since Stripe returns a signing secret only when an endpoint is created. The secret is available on the endpoint's page in the Stripe dashboard.

Actions​

Attach Card​

Attach a card to a customer.

InputCommentsDefault
Customer IDThe unique identifier for the customer.
Payment Method IDThe unique identifier for the payment method.
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. Enter a whole number in the currency's smallest unit (1000 is $10.00 in USD, ¥1000 in JPY).
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.
Additional FieldsAdditional optional fields: includes Application Fee Amount, Statement Descriptor, Statement Descriptor Suffix, and Transfer Data.
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. Enter a whole number in the currency's smallest unit (500 is $5.00 in USD, ¥500 in JPY).
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.
Capture MethodControls when the funds will be captured from the customer's account.
Additional FieldsAdditional optional fields: includes Setup Future Usage, Error On Requires Action, Mandate, Mandate Data, Off Session, Payment Method Data, Payment Method Options, Radar Options, Return URL, and Use Stripe SDK.
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.
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 AddressBilling street, city, state, postal code, and country.
Street AddressThe first line of the card's billing address, typically the street number and name.
Street Address Line 2Additional address information for the billing address (optional).
CityThe city portion of the card's billing address, used for address verification.
State/ProvinceThe state or province code for the billing address.
Zip/Postal CodeThe postal or ZIP code portion of the card's billing address, used for address verification.
CountryThe two-letter ISO country code for the billing address.
Name & Contact InformationFull name, email, and phone contact details.
Full NameThe cardholder name as it appears on the card, used for verification.
EmailThe email address Stripe uses for billing receipts and correspondence about this card.
PhoneThe phone number associated with the billing contact, including country code.
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 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
Name & Contact InformationFull name, email, and phone contact details.
Full NameThe customer's full name, displayed in the Stripe Dashboard and on receipts.
EmailThe customer's email address. Used for receipts, invoices, and other Stripe communications.
PhoneThe customer's phone number in E.164 format. Used for SMS receipts and Strong Customer Authentication.
AddressStreet, city, state, postal code, and country.
Street AddressThe first line of the customer's billing address, typically the street number and name.
Street 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.
State/ProvinceThe state, province, or region code for the customer's billing address (e.g., CA for California).
Zip/Postal CodeThe postal or ZIP code portion of the customer's billing address.
CountryThe two-letter ISO 3166-1 alpha-2 country code for the customer's billing address.
BalanceThe starting balance of the customer, as a whole number in the currency's smallest unit (5000 is $50.00 in USD, ¥5000 in JPY).
Default Payment Method IDThe unique identifier of the customer's default payment method.
DescriptionAn arbitrary description of the customer for internal reference.
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.
AmountThe amount intended to be collected, as a whole number in the currency's smallest unit (2000 is $20.00 in USD, ¥2000 in JPY).
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
Customer IDID 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.
Payment Method TypesThe list of payment method types that this PaymentIntent is allowed to use.
Transfer OptionsApplication fee, settlement account, transfer data, and transfer group for routing funds to connected accounts.
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. Enter a whole number in the currency's smallest unit (500 is $5.00 in USD, ¥500 in JPY).
On Behalf OfThe Stripe account ID for which these funds are intended.
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.
Additional FieldsAdditional optional fields: includes Setup Future Usage, Shipping, Statement Descriptor, Statement Descriptor Suffix, Capture Method, Confirmation Method, Error On Requires Action, Mandate, Mandate Data, Off Session, Payment Method Data, Payment Method Options, Radar Options, Return URL, and Use Stripe SDK.
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.
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.
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 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, as a whole number in the currency's smallest unit (2000 is $20.00 in USD, ¥2000 in JPY).
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.
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.
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 Intent 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 the platform.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
PaginationCursor and page-size controls for paging through results.
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.
SourceFilters results to only include transactions originating from the specified Stripe source ID (e.g., a charge or payout ID).
PaginationCursor and page-size controls for paging through results.
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.
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.
PaginationCursor and page-size controls for paging through results.
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.
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).
PaginationCursor and page-size controls for paging through results.
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.
PaginationCursor and page-size controls for paging through results.
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
PaginationCursor and page-size controls for paging through results.
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).
PaginationCursor and page-size controls for paging through results.
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.
Charge IDOnly 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.
PaginationCursor and page-size controls for paging through results.
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.

List Invoices​

Return a list of invoices.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
PaginationCursor and page-size controls for paging through results.
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.
Customer IDOnly return PaymentIntents for the customer specified by this customer ID.
CreatedA filter on the list based on the object created field.
PaginationCursor and page-size controls for paging through results.
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.

List Prices​

Return a list of all available prices.

InputCommentsDefault
TimeoutThe maximum time a client will await a response (in milliseconds).
PaginationCursor and page-size controls for paging through results.
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).
PaginationCursor and page-size controls for paging through results.
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).
PaginationCursor and page-size controls for paging through results.
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
PaginationCursor and page-size controls for paging through results.
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.
PaginationCursor and page-size controls for paging through results.
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.
PaginationCursor and page-size controls for paging through results.
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.
Payment Method IDThe unique identifier for the payment method.
Expiration MonthThe two-digit expiration month of the card (01-12).
Expiration YearThe four-digit expiration year of the card.
Billing AddressBilling street, city, state, postal code, and country.
Street AddressThe first line of the card's billing address, typically the street number and name.
Street Address Line 2Additional address information for the billing address (optional).
CityThe city portion of the card's billing address, used for address verification.
State/ProvinceThe state or province code for the billing address.
Zip/Postal CodeThe postal or ZIP code portion of the card's billing address, used for address verification.
CountryThe two-letter ISO country code for the billing address.
Name & Contact InformationFull name, email, and phone contact details.
Full NameThe cardholder name as it appears on the card, used for verification.
EmailThe email address Stripe uses for billing receipts and correspondence about this card.
PhoneThe phone number associated with the billing contact, including country code.
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.
Customer IDThe ID of an existing customer that will be associated with this request.
DescriptionAn arbitrary string that can be attached to a charge object. It is displayed 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 that can be attached 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.
Name & Contact InformationFull name, email, and phone contact details.
Full NameThe customer's full name, displayed in the Stripe Dashboard and on receipts.
EmailThe customer's email address. Used for receipts, invoices, and other Stripe communications.
PhoneThe customer's phone number in E.164 format. Used for SMS receipts and Strong Customer Authentication.
AddressStreet, city, state, postal code, and country.
Street AddressThe first line of the customer's billing address, typically the street number and name.
Street 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.
State/ProvinceThe state, province, or region code for the customer's billing address (e.g., CA for California).
Zip/Postal CodeThe postal or ZIP code portion of the customer's billing address.
CountryThe two-letter ISO 3166-1 alpha-2 country code for the customer's billing address.
BalanceThe starting balance of the customer, as a whole number in the currency's smallest unit (5000 is $50.00 in USD, ¥5000 in JPY).
DescriptionAn arbitrary description of the customer for internal reference.
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.
Collection MethodThe method used to collect payment for 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.
Additional FieldsAdditional optional fields: includes Auto Advance, Application Fee Amount, Coupon, and Discount.
Auto AdvanceWhen true, Stripe will automatically attempt collection of the invoice.false
Application Fee AmountThe application fee amount, as a whole number in the currency's smallest unit (500 is $5.00 in USD, ¥500 in JPY). Only applicable when collection method is 'Charge Automatically'.
CouponThe unique identifier of the coupon to apply to the invoice.
DiscountThe discount ID to apply to the invoice.
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.
AmountThe amount intended to be collected, as a whole number in the currency's smallest unit (2000 is $20.00 in USD, ¥2000 in JPY).
CurrencyThe three-letter ISO currency code in lowercase (e.g., usd, eur, gbp).
Customer IDID 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.
Payment Method TypesThe list of payment method types that this PaymentIntent is allowed to use.
Transfer OptionsApplication fee, transfer data, and transfer group for routing funds to connected accounts.
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. Enter a whole number in the currency's smallest unit (500 is $5.00 in USD, ¥500 in JPY).
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.
Additional FieldsAdditional optional fields: includes Setup Future Usage, Shipping, Statement Descriptor, Statement Descriptor Suffix, Capture Method, Payment Method Data, and Payment Method Options.
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.
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.

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.
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.
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.
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 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.