Stripe is a powerful payments platform that enables you to easily manage payments, customers, subscriptions, invoices, products, and more.
With Stripe integrated into Sim, your agents can:
- Create and manage payment intents: Process payments with flexible configuration options.
- Work with customers: Create, retrieve, and update customer records for your business.
- Handle subscriptions: Manage recurring billing and subscription lifecycles.
- Create and send invoices: Generate invoices for one-time or recurring payments.
- Track and manage charges: Retrieve and update charge objects for monitoring payments.
- Configure products and prices: Set up your catalog of products, pricing models, and offers.
- Listen and react to Stripe events: Trigger workflows in response to payment updates, successful charges, and other Stripe events.
By connecting Sim with Stripe, you enable seamless automation and financial operations within your agent workflows. Automate customer onboarding, subscription management, payment collection, invoice generation, and even custom actions when payment events occur—all handled directly by your agents, securely via Stripe.
Whether you’re building e-commerce automation, subscription services, or running reporting and reconciliation, the Stripe tool makes it easy to coordinate payments and financial data within your intelligent Sim workflows.
Usage Instructions
Integrates Stripe into the workflow. Manage payment intents, customers, subscriptions, invoices, charges, products, prices, and events. Can be used in trigger mode to trigger a workflow when a Stripe event occurs.
Tools
stripe_create_payment_intent
Create a new Payment Intent to process a payment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
amount | number | Yes | Amount in cents (e.g., 2000 for $20.00) |
currency | string | Yes | Three-letter ISO currency code (e.g., usd, eur) |
customer | string | No | Customer ID to associate with this payment |
payment_method | string | No | Payment method ID |
description | string | No | Description of the payment |
receipt_email | string | No | Email address to send receipt to |
metadata | json | No | Set of key-value pairs for storing additional information |
automatic_payment_methods | json | No | Enable automatic payment methods (e.g., {"enabled": true}) |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intent | object | The created Payment Intent object |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Payment Intent metadata including ID, status, amount, and currency |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_retrieve_payment_intent
Retrieve an existing Payment Intent by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Payment Intent ID (e.g., pi_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intent | object | The retrieved Payment Intent object |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Payment Intent metadata including ID, status, amount, and currency |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_update_payment_intent
Update an existing Payment Intent
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Payment Intent ID (e.g., pi_1234567890) |
amount | number | No | Updated amount in cents |
currency | string | No | Three-letter ISO currency code |
customer | string | No | Customer ID |
description | string | No | Updated description |
metadata | json | No | Updated metadata |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intent | object | The updated Payment Intent object |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Payment Intent metadata including ID, status, amount, and currency |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_confirm_payment_intent
Confirm a Payment Intent to complete the payment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Payment Intent ID (e.g., pi_1234567890) |
payment_method | string | No | Payment method ID to confirm with |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intent | object | The confirmed Payment Intent object |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Payment Intent metadata including ID, status, amount, and currency |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_capture_payment_intent
Capture an authorized Payment Intent
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Payment Intent ID (e.g., pi_1234567890) |
amount_to_capture | number | No | Amount to capture in cents (defaults to full amount) |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intent | object | The captured Payment Intent object |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Payment Intent metadata including ID, status, amount, and currency |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_cancel_payment_intent
Cancel a Payment Intent
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Payment Intent ID (e.g., pi_1234567890) |
cancellation_reason | string | No | Reason for cancellation (duplicate, fraudulent, requested_by_customer, abandoned) |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intent | object | The canceled Payment Intent object |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Payment Intent metadata including ID, status, amount, and currency |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_list_payment_intents
List all Payment Intents
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
customer | string | No | Filter by customer ID |
created | json | No | Filter by creation date (e.g., {"gt": 1633024800}) |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intents | array | Array of Payment Intent objects |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | List metadata including count and has_more |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_payment_intents
Search for Payment Intents using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "status:'succeeded' AND currency:'usd'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
payment_intents | array | Array of matching Payment Intent objects |
↳ id | string | Unique identifier for the Payment Intent |
↳ object | string | String representing the object type (payment_intent) |
↳ amount | number | Amount intended to be collected in smallest currency unit |
↳ amount_capturable | number | Amount that can be captured |
↳ amount_received | number | Amount that was collected |
↳ application | string | ID of the Connect application that created the PaymentIntent |
↳ application_fee_amount | number | Application fee amount (if any) |
↳ automatic_payment_methods | json | Settings for automatic payment methods |
↳ canceled_at | number | Unix timestamp of cancellation |
↳ cancellation_reason | string | Reason for cancellation |
↳ capture_method | string | Controls when funds will be captured (automatic or manual) |
↳ client_secret | string | Client secret for confirming the PaymentIntent |
↳ confirmation_method | string | How the PaymentIntent can be confirmed (automatic or manual) |
↳ created | number | Unix timestamp when the PaymentIntent was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ customer | string | ID of the Customer this PaymentIntent belongs to |
↳ description | string | Description of the payment |
↳ invoice | string | ID of the invoice that created this PaymentIntent |
↳ last_payment_error | json | The payment error encountered in the previous PaymentIntent confirmation |
↳ latest_charge | string | ID of the latest charge created by this PaymentIntent |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_action | json | Actions required before the PaymentIntent can be confirmed |
↳ on_behalf_of | string | The account on behalf of which to charge |
↳ payment_method | string | ID of the payment method used |
↳ payment_method_options | json | Payment-method-specific configuration |
↳ payment_method_types | array | Payment method types that can be used |
↳ processing | json | Processing status if payment is being processed asynchronously |
↳ receipt_email | string | Email address to send the receipt to |
↳ review | string | ID of the review associated with this PaymentIntent |
↳ setup_future_usage | string | Indicates intent to make future payments |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ statement_descriptor | string | Statement descriptor for charges |
↳ statement_descriptor_suffix | string | Statement descriptor suffix |
↳ status | string | Status of the PaymentIntent (requires_payment_method, requires_confirmation, requires_action, processing, requires_capture, canceled, succeeded) |
↳ transfer_data | json | The data for creating a transfer after the payment succeeds |
↳ transfer_group | string | Transfer group for transfers associated with the payment |
metadata | json | Search metadata including count and has_more |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_create_customer
Create a new customer object
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
email | string | No | Customer email address |
name | string | No | Customer full name |
phone | string | No | Customer phone number |
description | string | No | Description of the customer |
address | json | No | Customer address object |
metadata | json | No | Set of key-value pairs |
payment_method | string | No | Payment method ID to attach |
Output
| Parameter | Type | Description |
|---|---|---|
customer | object | The created customer object |
↳ id | string | Unique identifier for the customer |
↳ object | string | String representing the object type (customer) |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ balance | number | Current balance in smallest currency unit |
↳ created | number | Unix timestamp when the customer was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ default_source | string | ID of the default payment source |
↳ delinquent | boolean | Whether the customer has unpaid invoices |
↳ description | string | Description of the customer |
↳ discount | json | Discount that applies to all recurring charges |
↳ email | string | Customer email address (max 512 characters) |
↳ invoice_prefix | string | Prefix for generating unique invoice numbers |
↳ invoice_settings | json | Default invoice settings |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ name | string | Customer full name or business name (max 256 characters) |
↳ next_invoice_sequence | number | Next invoice sequence number |
↳ phone | string | Customer phone number (max 20 characters) |
↳ preferred_locales | array | Customer preferred locales |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ tax_exempt | string | Tax exemption status (none, exempt, reverse) |
↳ test_clock | string | ID of the test clock |
metadata | json | Customer metadata |
↳ id | string | Stripe unique identifier |
↳ email | string | Customer email address |
↳ name | string | Display name |
stripe_retrieve_customer
Retrieve an existing customer by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Customer ID (e.g., cus_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
customer | object | The retrieved customer object |
↳ id | string | Unique identifier for the customer |
↳ object | string | String representing the object type (customer) |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ balance | number | Current balance in smallest currency unit |
↳ created | number | Unix timestamp when the customer was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ default_source | string | ID of the default payment source |
↳ delinquent | boolean | Whether the customer has unpaid invoices |
↳ description | string | Description of the customer |
↳ discount | json | Discount that applies to all recurring charges |
↳ email | string | Customer email address (max 512 characters) |
↳ invoice_prefix | string | Prefix for generating unique invoice numbers |
↳ invoice_settings | json | Default invoice settings |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ name | string | Customer full name or business name (max 256 characters) |
↳ next_invoice_sequence | number | Next invoice sequence number |
↳ phone | string | Customer phone number (max 20 characters) |
↳ preferred_locales | array | Customer preferred locales |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ tax_exempt | string | Tax exemption status (none, exempt, reverse) |
↳ test_clock | string | ID of the test clock |
metadata | json | Customer metadata |
↳ id | string | Stripe unique identifier |
↳ email | string | Customer email address |
↳ name | string | Display name |
stripe_update_customer
Update an existing customer
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Customer ID (e.g., cus_1234567890) |
email | string | No | Updated email address |
name | string | No | Updated name |
phone | string | No | Updated phone number |
description | string | No | Updated description |
address | json | No | Updated address object |
metadata | json | No | Updated metadata |
Output
| Parameter | Type | Description |
|---|---|---|
customer | object | The updated customer object |
↳ id | string | Unique identifier for the customer |
↳ object | string | String representing the object type (customer) |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ balance | number | Current balance in smallest currency unit |
↳ created | number | Unix timestamp when the customer was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ default_source | string | ID of the default payment source |
↳ delinquent | boolean | Whether the customer has unpaid invoices |
↳ description | string | Description of the customer |
↳ discount | json | Discount that applies to all recurring charges |
↳ email | string | Customer email address (max 512 characters) |
↳ invoice_prefix | string | Prefix for generating unique invoice numbers |
↳ invoice_settings | json | Default invoice settings |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ name | string | Customer full name or business name (max 256 characters) |
↳ next_invoice_sequence | number | Next invoice sequence number |
↳ phone | string | Customer phone number (max 20 characters) |
↳ preferred_locales | array | Customer preferred locales |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ tax_exempt | string | Tax exemption status (none, exempt, reverse) |
↳ test_clock | string | ID of the test clock |
metadata | json | Customer metadata |
↳ id | string | Stripe unique identifier |
↳ email | string | Customer email address |
↳ name | string | Display name |
stripe_delete_customer
Permanently delete a customer
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Customer ID (e.g., cus_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
deleted | boolean | Whether the resource was deleted |
id | string | ID of the deleted resource |
stripe_list_customers
List all customers
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
email | string | No | Filter by email address |
created | json | No | Filter by creation date |
Output
| Parameter | Type | Description |
|---|---|---|
customers | array | Array of customer objects |
↳ id | string | Unique identifier for the customer |
↳ object | string | String representing the object type (customer) |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ balance | number | Current balance in smallest currency unit |
↳ created | number | Unix timestamp when the customer was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ default_source | string | ID of the default payment source |
↳ delinquent | boolean | Whether the customer has unpaid invoices |
↳ description | string | Description of the customer |
↳ discount | json | Discount that applies to all recurring charges |
↳ email | string | Customer email address (max 512 characters) |
↳ invoice_prefix | string | Prefix for generating unique invoice numbers |
↳ invoice_settings | json | Default invoice settings |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ name | string | Customer full name or business name (max 256 characters) |
↳ next_invoice_sequence | number | Next invoice sequence number |
↳ phone | string | Customer phone number (max 20 characters) |
↳ preferred_locales | array | Customer preferred locales |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ tax_exempt | string | Tax exemption status (none, exempt, reverse) |
↳ test_clock | string | ID of the test clock |
metadata | json | List metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_customers
Search for customers using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "email:'customer@example.com'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
customers | array | Array of matching customer objects |
↳ id | string | Unique identifier for the customer |
↳ object | string | String representing the object type (customer) |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ balance | number | Current balance in smallest currency unit |
↳ created | number | Unix timestamp when the customer was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ default_source | string | ID of the default payment source |
↳ delinquent | boolean | Whether the customer has unpaid invoices |
↳ description | string | Description of the customer |
↳ discount | json | Discount that applies to all recurring charges |
↳ email | string | Customer email address (max 512 characters) |
↳ invoice_prefix | string | Prefix for generating unique invoice numbers |
↳ invoice_settings | json | Default invoice settings |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ name | string | Customer full name or business name (max 256 characters) |
↳ next_invoice_sequence | number | Next invoice sequence number |
↳ phone | string | Customer phone number (max 20 characters) |
↳ preferred_locales | array | Customer preferred locales |
↳ shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ tax_exempt | string | Tax exemption status (none, exempt, reverse) |
↳ test_clock | string | ID of the test clock |
metadata | json | Search metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_create_subscription
Create a new subscription for a customer
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
customer | string | Yes | Customer ID to subscribe |
items | json | Yes | Array of items with price IDs (e.g., [{"price": "price_xxx", "quantity": 1}]) |
trial_period_days | number | No | Number of trial days |
default_payment_method | string | No | Payment method ID |
cancel_at_period_end | boolean | No | Cancel subscription at period end |
metadata | json | No | Set of key-value pairs for storing additional information |
Output
| Parameter | Type | Description |
|---|---|---|
subscription | object | The created subscription object |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | Subscription metadata including ID, status, and customer |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ customer | string | Associated customer ID |
stripe_retrieve_subscription
Retrieve an existing subscription by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Subscription ID (e.g., sub_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
subscription | object | The retrieved subscription object |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | Subscription metadata including ID, status, and customer |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ customer | string | Associated customer ID |
stripe_update_subscription
Update an existing subscription
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Subscription ID (e.g., sub_1234567890) |
items | json | No | Updated array of items with price IDs |
cancel_at_period_end | boolean | No | Cancel subscription at period end |
metadata | json | No | Updated metadata |
Output
| Parameter | Type | Description |
|---|---|---|
subscription | object | The updated subscription object |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | Subscription metadata including ID, status, and customer |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ customer | string | Associated customer ID |
stripe_cancel_subscription
Cancel a subscription
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Subscription ID (e.g., sub_1234567890) |
prorate | boolean | No | Whether to prorate the cancellation |
invoice_now | boolean | No | Whether to invoice immediately |
Output
| Parameter | Type | Description |
|---|---|---|
subscription | object | The canceled subscription object |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | Subscription metadata including ID, status, and customer |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ customer | string | Associated customer ID |
stripe_resume_subscription
Resume a subscription that was scheduled for cancellation
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Subscription ID (e.g., sub_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
subscription | object | The resumed subscription object |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | Subscription metadata including ID, status, and customer |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ customer | string | Associated customer ID |
stripe_list_subscriptions
List all subscriptions
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
customer | string | No | Filter by customer ID |
status | string | No | Filter by status (active, past_due, unpaid, canceled, incomplete, incomplete_expired, trialing, all) |
price | string | No | Filter by price ID |
Output
| Parameter | Type | Description |
|---|---|---|
subscriptions | array | Array of subscription objects |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | List metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_subscriptions
Search for subscriptions using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "status:'active' AND customer:'cus_xxx'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
subscriptions | array | Array of matching subscription objects |
↳ id | string | Unique identifier for the subscription |
↳ object | string | String representing the object type (subscription) |
↳ application | string | ID of the Connect application that created the subscription |
↳ application_fee_percent | number | Application fee percent (if any) |
↳ automatic_tax | json | Automatic tax settings |
↳ billing_cycle_anchor | number | Unix timestamp determining when billing cycle starts |
↳ billing_thresholds | json | Billing thresholds for the subscription |
↳ cancel_at | number | Unix timestamp when the subscription will be canceled |
↳ cancel_at_period_end | boolean | Whether the subscription will be canceled at period end |
↳ canceled_at | number | Unix timestamp when the subscription was canceled |
↳ cancellation_details | json | Details about cancellation |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the subscription was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ current_period_end | number | Unix timestamp when the current period ends |
↳ current_period_start | number | Unix timestamp when the current period started |
↳ customer | string | ID of the customer who owns the subscription |
↳ days_until_due | number | Number of days a customer has to pay invoices |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Subscription description (max 500 characters) |
↳ discount | json | Discount that applies to the subscription |
↳ ended_at | number | Unix timestamp when the subscription ended |
↳ latest_invoice | string | ID of the most recent invoice |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_pending_invoice_item_invoice | number | Unix timestamp of next pending invoice item invoice |
↳ on_behalf_of | string | Account the subscription is made on behalf of |
↳ pause_collection | json | If paused, when collection is paused until |
↳ payment_settings | json | Payment settings for the subscription |
↳ pending_invoice_item_interval | json | Pending invoice item interval |
↳ pending_setup_intent | string | ID of the pending SetupIntent |
↳ pending_update | json | Pending subscription update |
↳ schedule | string | ID of the subscription schedule |
↳ start_date | number | Unix timestamp when the subscription started |
↳ status | string | Status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused) |
↳ test_clock | string | ID of the test clock |
↳ transfer_data | json | Data for creating transfers after payments succeed |
↳ trial_end | number | Unix timestamp when the trial ends |
↳ trial_settings | json | Settings related to subscription trials |
↳ trial_start | number | Unix timestamp when the trial started |
metadata | json | Search metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_create_invoice
Create a new invoice
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
customer | string | Yes | Customer ID (e.g., cus_1234567890) |
description | string | No | Description of the invoice |
metadata | json | No | Set of key-value pairs |
auto_advance | boolean | No | Auto-finalize the invoice |
collection_method | string | No | Collection method: charge_automatically or send_invoice |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | object | The created invoice object |
↳ id | string | Unique identifier for the invoice |
↳ object | string | String representing the object type (invoice) |
↳ account_country | string | Country of the business associated with this invoice |
↳ account_name | string | Name of the account associated with this invoice |
↳ account_tax_ids | array | Account tax IDs |
↳ amount_due | number | Final amount due in smallest currency unit |
↳ amount_paid | number | Amount paid in smallest currency unit |
↳ amount_remaining | number | Amount remaining in smallest currency unit |
↳ amount_shipping | number | Shipping amount in smallest currency unit |
↳ application | string | ID of the Connect application that created the invoice |
↳ application_fee_amount | number | Application fee amount |
↳ attempt_count | number | Number of payment attempts made |
↳ attempted | boolean | Whether an attempt has been made to pay the invoice |
↳ auto_advance | boolean | Controls whether Stripe performs automatic collection |
↳ automatic_tax | json | Settings and results for automatic tax lookup |
↳ billing_reason | string | Reason the invoice was created |
↳ charge | string | ID of the latest charge for this invoice |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the invoice was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ custom_fields | array | Custom fields displayed on the invoice |
↳ customer | string | ID of the customer who will be billed |
↳ customer_address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_email | string | Email of the customer |
↳ customer_name | string | Name of the customer |
↳ customer_phone | string | Phone number of the customer |
↳ customer_shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_tax_exempt | string | Tax exemption status of the customer |
↳ customer_tax_ids | array | Customer tax IDs |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Description displayed in Dashboard (memo) |
↳ discount | json | Discount applied to the invoice |
↳ discounts | array | Discounts applied to the invoice |
↳ due_date | number | Unix timestamp when payment is due |
↳ effective_at | number | When the invoice was effective |
↳ ending_balance | number | Ending customer balance after invoice is finalized |
↳ footer | string | Footer displayed on the invoice |
↳ from_invoice | json | Details of the invoice that this invoice was created from |
↳ hosted_invoice_url | string | URL for the hosted invoice page |
↳ invoice_pdf | string | URL for the invoice PDF |
↳ issuer | json | The connected account that issues the invoice |
↳ last_finalization_error | json | Error encountered during finalization |
↳ latest_revision | string | ID of the most recent revision |
↳ lines | object | Invoice line items |
↳ id | string | Unique identifier for the line item |
↳ object | string | String representing the object type (line_item) |
↳ amount | number | Amount in smallest currency unit |
↳ amount_excluding_tax | number | Amount excluding tax |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ description | string | Description of the line item |
↳ discount_amounts | array | Discount amounts applied |
↳ discountable | boolean | Whether the line item is discountable |
↳ discounts | array | Discounts applied to the line item |
↳ invoice | string | ID of the invoice that contains this line item |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ period | json | Period this line item covers |
↳ price | json | Price object for this line item |
↳ proration | boolean | Whether this is a proration |
↳ proration_details | json | Additional details for proration line items |
↳ quantity | number | Quantity of the item |
↳ subscription | string | ID of the subscription |
↳ subscription_item | string | ID of the subscription item |
↳ tax_amounts | array | Tax amounts for this line item |
↳ tax_rates | array | Tax rates applied |
↳ type | string | Type of line item (invoiceitem or subscription) |
↳ unit_amount_excluding_tax | string | Unit amount excluding tax |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_payment_attempt | number | Unix timestamp of next payment attempt |
↳ number | string | Human-readable invoice number |
↳ on_behalf_of | string | Account on behalf of which the invoice was issued |
↳ paid | boolean | Whether payment was successfully collected |
↳ paid_out_of_band | boolean | Whether the invoice was paid out of band |
↳ payment_intent | string | ID of the PaymentIntent associated with the invoice |
↳ payment_settings | json | Configuration settings for payment collection |
↳ period_end | number | End of the usage period |
↳ period_start | number | Start of the usage period |
↳ post_payment_credit_notes_amount | number | Total of all post-payment credit notes |
↳ pre_payment_credit_notes_amount | number | Total of all pre-payment credit notes |
↳ quote | string | ID of the quote this invoice was generated from |
↳ receipt_number | string | Receipt number for the invoice |
↳ rendering | json | Invoice rendering options |
↳ rendering_options | json | Invoice rendering options (deprecated) |
↳ shipping_cost | json | Shipping cost information |
↳ shipping_details | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ starting_balance | number | Starting customer balance before invoice |
↳ statement_descriptor | string | Statement descriptor |
↳ status | string | Status of the invoice (draft, open, paid, uncollectible, void) |
↳ status_transitions | json | Timestamps at which the invoice status was updated |
↳ subscription | string | ID of the subscription for this invoice |
↳ subscription_details | json | Details about the subscription |
↳ subscription_proration_date | number | Only set for upcoming invoices with proration |
↳ subtotal | number | Total before discounts and taxes |
↳ subtotal_excluding_tax | number | Subtotal excluding tax |
↳ tax | number | Total tax amount |
↳ test_clock | string | ID of the test clock |
↳ threshold_reason | json | Details about why the invoice was created |
↳ total | number | Total after discounts and taxes |
↳ total_discount_amounts | array | Total discount amounts |
↳ total_excluding_tax | number | Total excluding tax |
↳ total_tax_amounts | array | Total tax amounts |
↳ transfer_data | json | Data for creating transfers |
↳ webhooks_delivered_at | number | Unix timestamp of webhooks delivery |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_retrieve_invoice
Retrieve an existing invoice by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | object | The retrieved invoice object |
↳ id | string | Unique identifier for the invoice |
↳ object | string | String representing the object type (invoice) |
↳ account_country | string | Country of the business associated with this invoice |
↳ account_name | string | Name of the account associated with this invoice |
↳ account_tax_ids | array | Account tax IDs |
↳ amount_due | number | Final amount due in smallest currency unit |
↳ amount_paid | number | Amount paid in smallest currency unit |
↳ amount_remaining | number | Amount remaining in smallest currency unit |
↳ amount_shipping | number | Shipping amount in smallest currency unit |
↳ application | string | ID of the Connect application that created the invoice |
↳ application_fee_amount | number | Application fee amount |
↳ attempt_count | number | Number of payment attempts made |
↳ attempted | boolean | Whether an attempt has been made to pay the invoice |
↳ auto_advance | boolean | Controls whether Stripe performs automatic collection |
↳ automatic_tax | json | Settings and results for automatic tax lookup |
↳ billing_reason | string | Reason the invoice was created |
↳ charge | string | ID of the latest charge for this invoice |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the invoice was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ custom_fields | array | Custom fields displayed on the invoice |
↳ customer | string | ID of the customer who will be billed |
↳ customer_address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_email | string | Email of the customer |
↳ customer_name | string | Name of the customer |
↳ customer_phone | string | Phone number of the customer |
↳ customer_shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_tax_exempt | string | Tax exemption status of the customer |
↳ customer_tax_ids | array | Customer tax IDs |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Description displayed in Dashboard (memo) |
↳ discount | json | Discount applied to the invoice |
↳ discounts | array | Discounts applied to the invoice |
↳ due_date | number | Unix timestamp when payment is due |
↳ effective_at | number | When the invoice was effective |
↳ ending_balance | number | Ending customer balance after invoice is finalized |
↳ footer | string | Footer displayed on the invoice |
↳ from_invoice | json | Details of the invoice that this invoice was created from |
↳ hosted_invoice_url | string | URL for the hosted invoice page |
↳ invoice_pdf | string | URL for the invoice PDF |
↳ issuer | json | The connected account that issues the invoice |
↳ last_finalization_error | json | Error encountered during finalization |
↳ latest_revision | string | ID of the most recent revision |
↳ lines | object | Invoice line items |
↳ id | string | Unique identifier for the line item |
↳ object | string | String representing the object type (line_item) |
↳ amount | number | Amount in smallest currency unit |
↳ amount_excluding_tax | number | Amount excluding tax |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ description | string | Description of the line item |
↳ discount_amounts | array | Discount amounts applied |
↳ discountable | boolean | Whether the line item is discountable |
↳ discounts | array | Discounts applied to the line item |
↳ invoice | string | ID of the invoice that contains this line item |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ period | json | Period this line item covers |
↳ price | json | Price object for this line item |
↳ proration | boolean | Whether this is a proration |
↳ proration_details | json | Additional details for proration line items |
↳ quantity | number | Quantity of the item |
↳ subscription | string | ID of the subscription |
↳ subscription_item | string | ID of the subscription item |
↳ tax_amounts | array | Tax amounts for this line item |
↳ tax_rates | array | Tax rates applied |
↳ type | string | Type of line item (invoiceitem or subscription) |
↳ unit_amount_excluding_tax | string | Unit amount excluding tax |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_payment_attempt | number | Unix timestamp of next payment attempt |
↳ number | string | Human-readable invoice number |
↳ on_behalf_of | string | Account on behalf of which the invoice was issued |
↳ paid | boolean | Whether payment was successfully collected |
↳ paid_out_of_band | boolean | Whether the invoice was paid out of band |
↳ payment_intent | string | ID of the PaymentIntent associated with the invoice |
↳ payment_settings | json | Configuration settings for payment collection |
↳ period_end | number | End of the usage period |
↳ period_start | number | Start of the usage period |
↳ post_payment_credit_notes_amount | number | Total of all post-payment credit notes |
↳ pre_payment_credit_notes_amount | number | Total of all pre-payment credit notes |
↳ quote | string | ID of the quote this invoice was generated from |
↳ receipt_number | string | Receipt number for the invoice |
↳ rendering | json | Invoice rendering options |
↳ rendering_options | json | Invoice rendering options (deprecated) |
↳ shipping_cost | json | Shipping cost information |
↳ shipping_details | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ starting_balance | number | Starting customer balance before invoice |
↳ statement_descriptor | string | Statement descriptor |
↳ status | string | Status of the invoice (draft, open, paid, uncollectible, void) |
↳ status_transitions | json | Timestamps at which the invoice status was updated |
↳ subscription | string | ID of the subscription for this invoice |
↳ subscription_details | json | Details about the subscription |
↳ subscription_proration_date | number | Only set for upcoming invoices with proration |
↳ subtotal | number | Total before discounts and taxes |
↳ subtotal_excluding_tax | number | Subtotal excluding tax |
↳ tax | number | Total tax amount |
↳ test_clock | string | ID of the test clock |
↳ threshold_reason | json | Details about why the invoice was created |
↳ total | number | Total after discounts and taxes |
↳ total_discount_amounts | array | Total discount amounts |
↳ total_excluding_tax | number | Total excluding tax |
↳ total_tax_amounts | array | Total tax amounts |
↳ transfer_data | json | Data for creating transfers |
↳ webhooks_delivered_at | number | Unix timestamp of webhooks delivery |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_update_invoice
Update an existing invoice
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
description | string | No | Description of the invoice |
metadata | json | No | Set of key-value pairs |
auto_advance | boolean | No | Auto-finalize the invoice |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | object | The updated invoice object |
↳ id | string | Unique identifier for the invoice |
↳ object | string | String representing the object type (invoice) |
↳ account_country | string | Country of the business associated with this invoice |
↳ account_name | string | Name of the account associated with this invoice |
↳ account_tax_ids | array | Account tax IDs |
↳ amount_due | number | Final amount due in smallest currency unit |
↳ amount_paid | number | Amount paid in smallest currency unit |
↳ amount_remaining | number | Amount remaining in smallest currency unit |
↳ amount_shipping | number | Shipping amount in smallest currency unit |
↳ application | string | ID of the Connect application that created the invoice |
↳ application_fee_amount | number | Application fee amount |
↳ attempt_count | number | Number of payment attempts made |
↳ attempted | boolean | Whether an attempt has been made to pay the invoice |
↳ auto_advance | boolean | Controls whether Stripe performs automatic collection |
↳ automatic_tax | json | Settings and results for automatic tax lookup |
↳ billing_reason | string | Reason the invoice was created |
↳ charge | string | ID of the latest charge for this invoice |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the invoice was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ custom_fields | array | Custom fields displayed on the invoice |
↳ customer | string | ID of the customer who will be billed |
↳ customer_address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_email | string | Email of the customer |
↳ customer_name | string | Name of the customer |
↳ customer_phone | string | Phone number of the customer |
↳ customer_shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_tax_exempt | string | Tax exemption status of the customer |
↳ customer_tax_ids | array | Customer tax IDs |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Description displayed in Dashboard (memo) |
↳ discount | json | Discount applied to the invoice |
↳ discounts | array | Discounts applied to the invoice |
↳ due_date | number | Unix timestamp when payment is due |
↳ effective_at | number | When the invoice was effective |
↳ ending_balance | number | Ending customer balance after invoice is finalized |
↳ footer | string | Footer displayed on the invoice |
↳ from_invoice | json | Details of the invoice that this invoice was created from |
↳ hosted_invoice_url | string | URL for the hosted invoice page |
↳ invoice_pdf | string | URL for the invoice PDF |
↳ issuer | json | The connected account that issues the invoice |
↳ last_finalization_error | json | Error encountered during finalization |
↳ latest_revision | string | ID of the most recent revision |
↳ lines | object | Invoice line items |
↳ id | string | Unique identifier for the line item |
↳ object | string | String representing the object type (line_item) |
↳ amount | number | Amount in smallest currency unit |
↳ amount_excluding_tax | number | Amount excluding tax |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ description | string | Description of the line item |
↳ discount_amounts | array | Discount amounts applied |
↳ discountable | boolean | Whether the line item is discountable |
↳ discounts | array | Discounts applied to the line item |
↳ invoice | string | ID of the invoice that contains this line item |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ period | json | Period this line item covers |
↳ price | json | Price object for this line item |
↳ proration | boolean | Whether this is a proration |
↳ proration_details | json | Additional details for proration line items |
↳ quantity | number | Quantity of the item |
↳ subscription | string | ID of the subscription |
↳ subscription_item | string | ID of the subscription item |
↳ tax_amounts | array | Tax amounts for this line item |
↳ tax_rates | array | Tax rates applied |
↳ type | string | Type of line item (invoiceitem or subscription) |
↳ unit_amount_excluding_tax | string | Unit amount excluding tax |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_payment_attempt | number | Unix timestamp of next payment attempt |
↳ number | string | Human-readable invoice number |
↳ on_behalf_of | string | Account on behalf of which the invoice was issued |
↳ paid | boolean | Whether payment was successfully collected |
↳ paid_out_of_band | boolean | Whether the invoice was paid out of band |
↳ payment_intent | string | ID of the PaymentIntent associated with the invoice |
↳ payment_settings | json | Configuration settings for payment collection |
↳ period_end | number | End of the usage period |
↳ period_start | number | Start of the usage period |
↳ post_payment_credit_notes_amount | number | Total of all post-payment credit notes |
↳ pre_payment_credit_notes_amount | number | Total of all pre-payment credit notes |
↳ quote | string | ID of the quote this invoice was generated from |
↳ receipt_number | string | Receipt number for the invoice |
↳ rendering | json | Invoice rendering options |
↳ rendering_options | json | Invoice rendering options (deprecated) |
↳ shipping_cost | json | Shipping cost information |
↳ shipping_details | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ starting_balance | number | Starting customer balance before invoice |
↳ statement_descriptor | string | Statement descriptor |
↳ status | string | Status of the invoice (draft, open, paid, uncollectible, void) |
↳ status_transitions | json | Timestamps at which the invoice status was updated |
↳ subscription | string | ID of the subscription for this invoice |
↳ subscription_details | json | Details about the subscription |
↳ subscription_proration_date | number | Only set for upcoming invoices with proration |
↳ subtotal | number | Total before discounts and taxes |
↳ subtotal_excluding_tax | number | Subtotal excluding tax |
↳ tax | number | Total tax amount |
↳ test_clock | string | ID of the test clock |
↳ threshold_reason | json | Details about why the invoice was created |
↳ total | number | Total after discounts and taxes |
↳ total_discount_amounts | array | Total discount amounts |
↳ total_excluding_tax | number | Total excluding tax |
↳ total_tax_amounts | array | Total tax amounts |
↳ transfer_data | json | Data for creating transfers |
↳ webhooks_delivered_at | number | Unix timestamp of webhooks delivery |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_delete_invoice
Permanently delete a draft invoice
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
deleted | boolean | Whether the invoice was deleted |
id | string | The ID of the deleted invoice |
stripe_finalize_invoice
Finalize a draft invoice
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
auto_advance | boolean | No | Auto-advance the invoice |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | object | The finalized invoice object |
↳ id | string | Unique identifier for the invoice |
↳ object | string | String representing the object type (invoice) |
↳ account_country | string | Country of the business associated with this invoice |
↳ account_name | string | Name of the account associated with this invoice |
↳ account_tax_ids | array | Account tax IDs |
↳ amount_due | number | Final amount due in smallest currency unit |
↳ amount_paid | number | Amount paid in smallest currency unit |
↳ amount_remaining | number | Amount remaining in smallest currency unit |
↳ amount_shipping | number | Shipping amount in smallest currency unit |
↳ application | string | ID of the Connect application that created the invoice |
↳ application_fee_amount | number | Application fee amount |
↳ attempt_count | number | Number of payment attempts made |
↳ attempted | boolean | Whether an attempt has been made to pay the invoice |
↳ auto_advance | boolean | Controls whether Stripe performs automatic collection |
↳ automatic_tax | json | Settings and results for automatic tax lookup |
↳ billing_reason | string | Reason the invoice was created |
↳ charge | string | ID of the latest charge for this invoice |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the invoice was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ custom_fields | array | Custom fields displayed on the invoice |
↳ customer | string | ID of the customer who will be billed |
↳ customer_address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_email | string | Email of the customer |
↳ customer_name | string | Name of the customer |
↳ customer_phone | string | Phone number of the customer |
↳ customer_shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_tax_exempt | string | Tax exemption status of the customer |
↳ customer_tax_ids | array | Customer tax IDs |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Description displayed in Dashboard (memo) |
↳ discount | json | Discount applied to the invoice |
↳ discounts | array | Discounts applied to the invoice |
↳ due_date | number | Unix timestamp when payment is due |
↳ effective_at | number | When the invoice was effective |
↳ ending_balance | number | Ending customer balance after invoice is finalized |
↳ footer | string | Footer displayed on the invoice |
↳ from_invoice | json | Details of the invoice that this invoice was created from |
↳ hosted_invoice_url | string | URL for the hosted invoice page |
↳ invoice_pdf | string | URL for the invoice PDF |
↳ issuer | json | The connected account that issues the invoice |
↳ last_finalization_error | json | Error encountered during finalization |
↳ latest_revision | string | ID of the most recent revision |
↳ lines | object | Invoice line items |
↳ id | string | Unique identifier for the line item |
↳ object | string | String representing the object type (line_item) |
↳ amount | number | Amount in smallest currency unit |
↳ amount_excluding_tax | number | Amount excluding tax |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ description | string | Description of the line item |
↳ discount_amounts | array | Discount amounts applied |
↳ discountable | boolean | Whether the line item is discountable |
↳ discounts | array | Discounts applied to the line item |
↳ invoice | string | ID of the invoice that contains this line item |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ period | json | Period this line item covers |
↳ price | json | Price object for this line item |
↳ proration | boolean | Whether this is a proration |
↳ proration_details | json | Additional details for proration line items |
↳ quantity | number | Quantity of the item |
↳ subscription | string | ID of the subscription |
↳ subscription_item | string | ID of the subscription item |
↳ tax_amounts | array | Tax amounts for this line item |
↳ tax_rates | array | Tax rates applied |
↳ type | string | Type of line item (invoiceitem or subscription) |
↳ unit_amount_excluding_tax | string | Unit amount excluding tax |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_payment_attempt | number | Unix timestamp of next payment attempt |
↳ number | string | Human-readable invoice number |
↳ on_behalf_of | string | Account on behalf of which the invoice was issued |
↳ paid | boolean | Whether payment was successfully collected |
↳ paid_out_of_band | boolean | Whether the invoice was paid out of band |
↳ payment_intent | string | ID of the PaymentIntent associated with the invoice |
↳ payment_settings | json | Configuration settings for payment collection |
↳ period_end | number | End of the usage period |
↳ period_start | number | Start of the usage period |
↳ post_payment_credit_notes_amount | number | Total of all post-payment credit notes |
↳ pre_payment_credit_notes_amount | number | Total of all pre-payment credit notes |
↳ quote | string | ID of the quote this invoice was generated from |
↳ receipt_number | string | Receipt number for the invoice |
↳ rendering | json | Invoice rendering options |
↳ rendering_options | json | Invoice rendering options (deprecated) |
↳ shipping_cost | json | Shipping cost information |
↳ shipping_details | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ starting_balance | number | Starting customer balance before invoice |
↳ statement_descriptor | string | Statement descriptor |
↳ status | string | Status of the invoice (draft, open, paid, uncollectible, void) |
↳ status_transitions | json | Timestamps at which the invoice status was updated |
↳ subscription | string | ID of the subscription for this invoice |
↳ subscription_details | json | Details about the subscription |
↳ subscription_proration_date | number | Only set for upcoming invoices with proration |
↳ subtotal | number | Total before discounts and taxes |
↳ subtotal_excluding_tax | number | Subtotal excluding tax |
↳ tax | number | Total tax amount |
↳ test_clock | string | ID of the test clock |
↳ threshold_reason | json | Details about why the invoice was created |
↳ total | number | Total after discounts and taxes |
↳ total_discount_amounts | array | Total discount amounts |
↳ total_excluding_tax | number | Total excluding tax |
↳ total_tax_amounts | array | Total tax amounts |
↳ transfer_data | json | Data for creating transfers |
↳ webhooks_delivered_at | number | Unix timestamp of webhooks delivery |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_pay_invoice
Pay an invoice
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
paid_out_of_band | boolean | No | Mark invoice as paid out of band |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | object | The paid invoice object |
↳ id | string | Unique identifier for the invoice |
↳ object | string | String representing the object type (invoice) |
↳ account_country | string | Country of the business associated with this invoice |
↳ account_name | string | Name of the account associated with this invoice |
↳ account_tax_ids | array | Account tax IDs |
↳ amount_due | number | Final amount due in smallest currency unit |
↳ amount_paid | number | Amount paid in smallest currency unit |
↳ amount_remaining | number | Amount remaining in smallest currency unit |
↳ amount_shipping | number | Shipping amount in smallest currency unit |
↳ application | string | ID of the Connect application that created the invoice |
↳ application_fee_amount | number | Application fee amount |
↳ attempt_count | number | Number of payment attempts made |
↳ attempted | boolean | Whether an attempt has been made to pay the invoice |
↳ auto_advance | boolean | Controls whether Stripe performs automatic collection |
↳ automatic_tax | json | Settings and results for automatic tax lookup |
↳ billing_reason | string | Reason the invoice was created |
↳ charge | string | ID of the latest charge for this invoice |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the invoice was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ custom_fields | array | Custom fields displayed on the invoice |
↳ customer | string | ID of the customer who will be billed |
↳ customer_address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_email | string | Email of the customer |
↳ customer_name | string | Name of the customer |
↳ customer_phone | string | Phone number of the customer |
↳ customer_shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_tax_exempt | string | Tax exemption status of the customer |
↳ customer_tax_ids | array | Customer tax IDs |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Description displayed in Dashboard (memo) |
↳ discount | json | Discount applied to the invoice |
↳ discounts | array | Discounts applied to the invoice |
↳ due_date | number | Unix timestamp when payment is due |
↳ effective_at | number | When the invoice was effective |
↳ ending_balance | number | Ending customer balance after invoice is finalized |
↳ footer | string | Footer displayed on the invoice |
↳ from_invoice | json | Details of the invoice that this invoice was created from |
↳ hosted_invoice_url | string | URL for the hosted invoice page |
↳ invoice_pdf | string | URL for the invoice PDF |
↳ issuer | json | The connected account that issues the invoice |
↳ last_finalization_error | json | Error encountered during finalization |
↳ latest_revision | string | ID of the most recent revision |
↳ lines | object | Invoice line items |
↳ id | string | Unique identifier for the line item |
↳ object | string | String representing the object type (line_item) |
↳ amount | number | Amount in smallest currency unit |
↳ amount_excluding_tax | number | Amount excluding tax |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ description | string | Description of the line item |
↳ discount_amounts | array | Discount amounts applied |
↳ discountable | boolean | Whether the line item is discountable |
↳ discounts | array | Discounts applied to the line item |
↳ invoice | string | ID of the invoice that contains this line item |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ period | json | Period this line item covers |
↳ price | json | Price object for this line item |
↳ proration | boolean | Whether this is a proration |
↳ proration_details | json | Additional details for proration line items |
↳ quantity | number | Quantity of the item |
↳ subscription | string | ID of the subscription |
↳ subscription_item | string | ID of the subscription item |
↳ tax_amounts | array | Tax amounts for this line item |
↳ tax_rates | array | Tax rates applied |
↳ type | string | Type of line item (invoiceitem or subscription) |
↳ unit_amount_excluding_tax | string | Unit amount excluding tax |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_payment_attempt | number | Unix timestamp of next payment attempt |
↳ number | string | Human-readable invoice number |
↳ on_behalf_of | string | Account on behalf of which the invoice was issued |
↳ paid | boolean | Whether payment was successfully collected |
↳ paid_out_of_band | boolean | Whether the invoice was paid out of band |
↳ payment_intent | string | ID of the PaymentIntent associated with the invoice |
↳ payment_settings | json | Configuration settings for payment collection |
↳ period_end | number | End of the usage period |
↳ period_start | number | Start of the usage period |
↳ post_payment_credit_notes_amount | number | Total of all post-payment credit notes |
↳ pre_payment_credit_notes_amount | number | Total of all pre-payment credit notes |
↳ quote | string | ID of the quote this invoice was generated from |
↳ receipt_number | string | Receipt number for the invoice |
↳ rendering | json | Invoice rendering options |
↳ rendering_options | json | Invoice rendering options (deprecated) |
↳ shipping_cost | json | Shipping cost information |
↳ shipping_details | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ starting_balance | number | Starting customer balance before invoice |
↳ statement_descriptor | string | Statement descriptor |
↳ status | string | Status of the invoice (draft, open, paid, uncollectible, void) |
↳ status_transitions | json | Timestamps at which the invoice status was updated |
↳ subscription | string | ID of the subscription for this invoice |
↳ subscription_details | json | Details about the subscription |
↳ subscription_proration_date | number | Only set for upcoming invoices with proration |
↳ subtotal | number | Total before discounts and taxes |
↳ subtotal_excluding_tax | number | Subtotal excluding tax |
↳ tax | number | Total tax amount |
↳ test_clock | string | ID of the test clock |
↳ threshold_reason | json | Details about why the invoice was created |
↳ total | number | Total after discounts and taxes |
↳ total_discount_amounts | array | Total discount amounts |
↳ total_excluding_tax | number | Total excluding tax |
↳ total_tax_amounts | array | Total tax amounts |
↳ transfer_data | json | Data for creating transfers |
↳ webhooks_delivered_at | number | Unix timestamp of webhooks delivery |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_void_invoice
Void an invoice
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | object | The voided invoice object |
↳ id | string | Unique identifier for the invoice |
↳ object | string | String representing the object type (invoice) |
↳ account_country | string | Country of the business associated with this invoice |
↳ account_name | string | Name of the account associated with this invoice |
↳ account_tax_ids | array | Account tax IDs |
↳ amount_due | number | Final amount due in smallest currency unit |
↳ amount_paid | number | Amount paid in smallest currency unit |
↳ amount_remaining | number | Amount remaining in smallest currency unit |
↳ amount_shipping | number | Shipping amount in smallest currency unit |
↳ application | string | ID of the Connect application that created the invoice |
↳ application_fee_amount | number | Application fee amount |
↳ attempt_count | number | Number of payment attempts made |
↳ attempted | boolean | Whether an attempt has been made to pay the invoice |
↳ auto_advance | boolean | Controls whether Stripe performs automatic collection |
↳ automatic_tax | json | Settings and results for automatic tax lookup |
↳ billing_reason | string | Reason the invoice was created |
↳ charge | string | ID of the latest charge for this invoice |
↳ collection_method | string | Collection method (charge_automatically or send_invoice) |
↳ created | number | Unix timestamp when the invoice was created |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ custom_fields | array | Custom fields displayed on the invoice |
↳ customer | string | ID of the customer who will be billed |
↳ customer_address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_email | string | Email of the customer |
↳ customer_name | string | Name of the customer |
↳ customer_phone | string | Phone number of the customer |
↳ customer_shipping | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ customer_tax_exempt | string | Tax exemption status of the customer |
↳ customer_tax_ids | array | Customer tax IDs |
↳ default_payment_method | string | ID of the default payment method |
↳ default_source | string | ID of the default source |
↳ default_tax_rates | array | Default tax rates |
↳ description | string | Description displayed in Dashboard (memo) |
↳ discount | json | Discount applied to the invoice |
↳ discounts | array | Discounts applied to the invoice |
↳ due_date | number | Unix timestamp when payment is due |
↳ effective_at | number | When the invoice was effective |
↳ ending_balance | number | Ending customer balance after invoice is finalized |
↳ footer | string | Footer displayed on the invoice |
↳ from_invoice | json | Details of the invoice that this invoice was created from |
↳ hosted_invoice_url | string | URL for the hosted invoice page |
↳ invoice_pdf | string | URL for the invoice PDF |
↳ issuer | json | The connected account that issues the invoice |
↳ last_finalization_error | json | Error encountered during finalization |
↳ latest_revision | string | ID of the most recent revision |
↳ lines | object | Invoice line items |
↳ id | string | Unique identifier for the line item |
↳ object | string | String representing the object type (line_item) |
↳ amount | number | Amount in smallest currency unit |
↳ amount_excluding_tax | number | Amount excluding tax |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ description | string | Description of the line item |
↳ discount_amounts | array | Discount amounts applied |
↳ discountable | boolean | Whether the line item is discountable |
↳ discounts | array | Discounts applied to the line item |
↳ invoice | string | ID of the invoice that contains this line item |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ period | json | Period this line item covers |
↳ price | json | Price object for this line item |
↳ proration | boolean | Whether this is a proration |
↳ proration_details | json | Additional details for proration line items |
↳ quantity | number | Quantity of the item |
↳ subscription | string | ID of the subscription |
↳ subscription_item | string | ID of the subscription item |
↳ tax_amounts | array | Tax amounts for this line item |
↳ tax_rates | array | Tax rates applied |
↳ type | string | Type of line item (invoiceitem or subscription) |
↳ unit_amount_excluding_tax | string | Unit amount excluding tax |
↳ livemode | boolean | Whether object exists in live mode or test mode |
↳ metadata | json | Set of key-value pairs for storing additional information |
↳ next_payment_attempt | number | Unix timestamp of next payment attempt |
↳ number | string | Human-readable invoice number |
↳ on_behalf_of | string | Account on behalf of which the invoice was issued |
↳ paid | boolean | Whether payment was successfully collected |
↳ paid_out_of_band | boolean | Whether the invoice was paid out of band |
↳ payment_intent | string | ID of the PaymentIntent associated with the invoice |
↳ payment_settings | json | Configuration settings for payment collection |
↳ period_end | number | End of the usage period |
↳ period_start | number | Start of the usage period |
↳ post_payment_credit_notes_amount | number | Total of all post-payment credit notes |
↳ pre_payment_credit_notes_amount | number | Total of all pre-payment credit notes |
↳ quote | string | ID of the quote this invoice was generated from |
↳ receipt_number | string | Receipt number for the invoice |
↳ rendering | json | Invoice rendering options |
↳ rendering_options | json | Invoice rendering options (deprecated) |
↳ shipping_cost | json | Shipping cost information |
↳ shipping_details | object | Shipping information |
↳ name | string | Recipient name |
↳ phone | string | Recipient phone number |
↳ address | object | Address object |
↳ line1 | string | Address line 1 (street address) |
↳ line2 | string | Address line 2 (apartment, suite, etc.) |
↳ city | string | City name |
↳ state | string | State, county, province, or region |
↳ postal_code | string | ZIP or postal code |
↳ country | string | Two-letter country code (ISO 3166-1 alpha-2) |
↳ starting_balance | number | Starting customer balance before invoice |
↳ statement_descriptor | string | Statement descriptor |
↳ status | string | Status of the invoice (draft, open, paid, uncollectible, void) |
↳ status_transitions | json | Timestamps at which the invoice status was updated |
↳ subscription | string | ID of the subscription for this invoice |
↳ subscription_details | json | Details about the subscription |
↳ subscription_proration_date | number | Only set for upcoming invoices with proration |
↳ subtotal | number | Total before discounts and taxes |
↳ subtotal_excluding_tax | number | Subtotal excluding tax |
↳ tax | number | Total tax amount |
↳ test_clock | string | ID of the test clock |
↳ threshold_reason | json | Details about why the invoice was created |
↳ total | number | Total after discounts and taxes |
↳ total_discount_amounts | array | Total discount amounts |
↳ total_excluding_tax | number | Total excluding tax |
↳ total_tax_amounts | array | Total tax amounts |
↳ transfer_data | json | Data for creating transfers |
↳ webhooks_delivered_at | number | Unix timestamp of webhooks delivery |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_send_invoice
Send an invoice to the customer
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Invoice ID (e.g., in_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
invoice | json | The sent invoice object |
metadata | json | Invoice metadata |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount_due | number | Amount remaining to be paid in smallest currency unit |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_list_invoices
List all invoices
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
customer | string | No | Filter by customer ID |
status | string | No | Filter by invoice status |
Output
| Parameter | Type | Description |
|---|---|---|
invoices | json | Array of invoice objects |
metadata | json | List metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_invoices
Search for invoices using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "customer:'cus_1234567890'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
invoices | json | Array of matching invoice objects |
metadata | json | Search metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_create_charge
Create a new charge to process a payment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
amount | number | Yes | Amount in cents (e.g., 2000 for $20.00) |
currency | string | Yes | Three-letter ISO currency code (e.g., usd, eur) |
customer | string | No | Customer ID to associate with this charge |
source | string | No | Payment source ID (e.g., card token or saved card ID) |
description | string | No | Description of the charge |
metadata | json | No | Set of key-value pairs for storing additional information |
capture | boolean | No | Whether to immediately capture the charge (defaults to true) |
Output
| Parameter | Type | Description |
|---|---|---|
charge | json | The created Charge object |
metadata | json | Charge metadata including ID, status, amount, currency, and paid status |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ paid | boolean | Whether payment has been received |
stripe_retrieve_charge
Retrieve an existing charge by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Charge ID (e.g., ch_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
charge | json | The retrieved Charge object |
metadata | json | Charge metadata including ID, status, amount, currency, and paid status |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ paid | boolean | Whether payment has been received |
stripe_update_charge
Update an existing charge
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Charge ID (e.g., ch_1234567890) |
description | string | No | Updated description |
metadata | json | No | Updated metadata |
Output
| Parameter | Type | Description |
|---|---|---|
charge | json | The updated Charge object |
metadata | json | Charge metadata including ID, status, amount, currency, and paid status |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ paid | boolean | Whether payment has been received |
stripe_capture_charge
Capture an uncaptured charge
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Charge ID (e.g., ch_1234567890) |
amount | number | No | Amount to capture in cents (defaults to full amount) |
Output
| Parameter | Type | Description |
|---|---|---|
charge | json | The captured Charge object |
metadata | json | Charge metadata including ID, status, amount, currency, and paid status |
↳ id | string | Stripe unique identifier |
↳ status | string | Current state of the resource |
↳ amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
↳ paid | boolean | Whether payment has been received |
stripe_list_charges
List all charges
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
customer | string | No | Filter by customer ID |
created | json | No | Filter by creation date (e.g., {"gt": 1633024800}) |
Output
| Parameter | Type | Description |
|---|---|---|
charges | json | Array of Charge objects |
metadata | json | List metadata including count and has_more |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_charges
Search for charges using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "status:'succeeded' AND currency:'usd'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
charges | json | Array of matching Charge objects |
metadata | json | Search metadata including count and has_more |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_create_product
Create a new product object
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
name | string | Yes | Product name |
description | string | No | Product description |
active | boolean | No | Whether the product is active |
images | json | No | Array of image URLs for the product |
metadata | json | No | Set of key-value pairs |
Output
| Parameter | Type | Description |
|---|---|---|
product | json | The created product object |
metadata | json | Product metadata |
↳ id | string | Stripe unique identifier |
↳ name | string | Display name |
↳ active | boolean | Whether the resource is currently active |
stripe_retrieve_product
Retrieve an existing product by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Product ID (e.g., prod_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
product | json | The retrieved product object |
metadata | json | Product metadata |
↳ id | string | Stripe unique identifier |
↳ name | string | Display name |
↳ active | boolean | Whether the resource is currently active |
stripe_update_product
Update an existing product
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Product ID (e.g., prod_1234567890) |
name | string | No | Updated product name |
description | string | No | Updated product description |
active | boolean | No | Updated active status |
images | json | No | Updated array of image URLs |
metadata | json | No | Updated metadata |
Output
| Parameter | Type | Description |
|---|---|---|
product | json | The updated product object |
metadata | json | Product metadata |
↳ id | string | Stripe unique identifier |
↳ name | string | Display name |
↳ active | boolean | Whether the resource is currently active |
stripe_delete_product
Permanently delete a product
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Product ID (e.g., prod_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
deleted | boolean | Whether the product was deleted |
id | string | The ID of the deleted product |
stripe_list_products
List all products
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
active | boolean | No | Filter by active status |
Output
| Parameter | Type | Description |
|---|---|---|
products | json | Array of product objects |
metadata | json | List metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_products
Search for products using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "name:'shirt'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
products | json | Array of matching product objects |
metadata | json | Search metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_create_price
Create a new price for a product
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
product | string | Yes | Product ID (e.g., prod_1234567890) |
currency | string | Yes | Three-letter ISO currency code (e.g., usd, eur) |
unit_amount | number | No | Amount in cents (e.g., 1000 for $10.00) |
recurring | json | No | Recurring billing configuration (interval: day/week/month/year) |
metadata | json | No | Set of key-value pairs |
billing_scheme | string | No | Billing scheme (per_unit or tiered) |
Output
| Parameter | Type | Description |
|---|---|---|
price | json | The created price object |
metadata | json | Price metadata |
↳ id | string | Stripe unique identifier |
↳ product | string | Associated product ID |
↳ unit_amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_retrieve_price
Retrieve an existing price by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Price ID (e.g., price_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
price | json | The retrieved price object |
metadata | json | Price metadata |
↳ id | string | Stripe unique identifier |
↳ product | string | Associated product ID |
↳ unit_amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_update_price
Update an existing price
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Price ID (e.g., price_1234567890) |
active | boolean | No | Whether the price is active |
metadata | json | No | Updated metadata |
Output
| Parameter | Type | Description |
|---|---|---|
price | json | The updated price object |
metadata | json | Price metadata |
↳ id | string | Stripe unique identifier |
↳ product | string | Associated product ID |
↳ unit_amount | number | Amount in smallest currency unit (e.g., cents) |
↳ currency | string | Three-letter ISO currency code (lowercase) |
stripe_list_prices
List all prices
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
product | string | No | Filter by product ID |
active | boolean | No | Filter by active status |
Output
| Parameter | Type | Description |
|---|---|---|
prices | json | Array of price objects |
metadata | json | List metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_search_prices
Search for prices using query syntax
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
query | string | Yes | Search query (e.g., "active:'true' AND currency:'usd'") |
limit | number | No | Number of results to return (default 10, max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
prices | json | Array of matching price objects |
metadata | json | Search metadata |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |
stripe_retrieve_event
Retrieve an existing Event by ID
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
id | string | Yes | Event ID (e.g., evt_1234567890) |
Output
| Parameter | Type | Description |
|---|---|---|
event | json | The retrieved Event object |
metadata | json | Event metadata including ID, type, and created timestamp |
↳ id | string | Stripe unique identifier |
↳ type | string | Event type identifier |
↳ created | number | Unix timestamp of creation |
stripe_list_events
List all Events
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Stripe API key (secret key) |
limit | number | No | Number of results to return (default 10, max 100) |
type | string | No | Filter by event type (e.g., payment_intent.created) |
created | json | No | Filter by creation date (e.g., {"gt": 1633024800}) |
Output
| Parameter | Type | Description |
|---|---|---|
events | json | Array of Event objects |
metadata | json | List metadata including count and has_more |
↳ count | number | Number of items returned |
↳ has_more | boolean | Whether more items exist beyond this page |