Stripe

​

Overview

Complete payment processing platform with support for payments, subscriptions, invoicing, and financial services. Through Langdock’s integration, you can access and manage Stripe directly from your conversations.

​

Available Actions

​

Create customer

stripe.createcustomer

Creates a new customer in Stripe. Use the Email and Name fields for basic info, and Custom Parameters for all other Stripe customer fields. Requires Confirmation: Yes Parameters:

• email (TEXT, Optional): Customer’s email address. This will be their primary contact and used for invoices.
  • name (TEXT, Optional): Customer’s full name or business name. This appears on invoices and in the Stripe dashboard.
  • customParameters (TEXT, Optional): Additional Stripe customer parameters as JSON object. Common fields: description, phone, address (with line1, city, postal_code, country), shipping, metadata (for custom data like orgID, timezone), preferred_locales, tax_exempt, tax_id_data (array of tax IDs). For German VAT: tax_id_data: [type’: ‘eu_vat’, ‘value’: ‘DE123456789]. Full example: description’: ‘Company ABC’, ‘phone’: ‘+1234567890’, ‘address’: line1’: ‘123 Main St’, ‘city’: ‘Berlin’, ‘postal_code’: ‘10115’, ‘country’: ‘DE, ‘metadata’: orgID’: ‘workspace_123’, ‘timezone’: ‘Europe/Berlin, ‘tax_id_data’: [type’: ‘eu_vat’, ‘value’: ‘DE123456789]}

Output: Returns the created customer details

---

​

Update customer

stripe.updatecustomer

Updates an existing customer’s information Requires Confirmation: Yes Parameters:

• customerId (TEXT, Required): The ID of the customer to update (e.g., cus_…)
  • email (TEXT, Optional): Customer’s email address
  • name (TEXT, Optional): Customer’s full name or business name
  • description (TEXT, Optional): An arbitrary string that you can attach to a customer object
  • phone (TEXT, Optional): Customer’s phone number
  • metadata (TEXT, Optional): Set of key-value pairs that you can attach to an object

Output: Returns the updated customer details

---

​

Get customer

stripe.getcustomer

Retrieves a customer by ID Requires Confirmation: No Parameters:

• customerId (TEXT, Required): The ID of the customer to retrieve

Output: Returns the customer details

---

​

List customers

stripe.listcustomers

Lists all customers with optional filtering Requires Confirmation: No Parameters:

• email (TEXT, Optional): Filter customers by email address
  • limit (NUMBER, Optional): Maximum number of customers to return (1-100)

Output: Returns a list of customers

---

​

Create payment intent

stripe.createpaymentintent

Creates a new payment intent for collecting payment Requires Confirmation: Yes Parameters:

• amount (NUMBER, Required): Amount to be collected in the smallest currency unit (e.g., cents for USD)
  • currency (TEXT, Required): Three-letter ISO currency code (e.g., usd, eur, gbp)
  • customerId (TEXT, Optional): ID of the customer this payment intent is for
  • description (TEXT, Optional): An arbitrary string attached to the object
  • metadata (TEXT, Optional): Set of key-value pairs that you can attach to an object
  • paymentMethodTypes (TEXT, Optional): Array of payment method types to accept. Example: [‘card’, ‘customer_balance’] - use ‘customer_balance’ for bank transfers
  • paymentMethodOptions (TEXT, Optional): Additional options for payment methods. For bank transfers use: customer_balance’: funding_type’: ‘bank_transfer’, ‘bank_transfer’: type’: ‘eu_bank_transfer}} or ‘us_bank_transfer’ for US

Output: Returns the created payment intent details

---

​

Confirm payment intent

stripe.confirmpaymentintent

Confirms a payment intent to finalize the payment Requires Confirmation: Yes Parameters:

• paymentIntentId (TEXT, Required): The ID of the payment intent to confirm
  • paymentMethodId (TEXT, Optional): ID of the payment method to use

Output: Returns the confirmed payment intent details

---

​

Create subscription

stripe.createsubscription

Creates a new subscription for a customer Requires Confirmation: Yes Parameters:

• customerId (TEXT, Required): The ID of the customer to subscribe
  • items (TEXT, Required): List of subscription items, each with a price ID. Example: [price’: ‘price_1234]
  • trialPeriodDays (NUMBER, Optional): Number of trial period days for the subscription
  • metadata (TEXT, Optional): Set of key-value pairs that you can attach to an object
  • defaultPaymentMethod (TEXT, Optional): ID of the default payment method for the subscription
  • collectionMethod (SELECT, Optional): How to collect payment for the subscription. Use ‘send_invoice’ for manual bank transfers
  • daysUntilDue (NUMBER, Optional): Number of days until the invoice is due (only used when collection_method is ‘send_invoice’)
  • paymentSettings (TEXT, Optional): Payment settings for the subscription. For bank transfers: payment_method_types’: [‘customer_balance’], ‘payment_method_options’: customer_balance’: funding_type’: ‘bank_transfer}}
  • defaultTaxRates (TEXT, Optional): Array of tax rate IDs to apply to the subscription. Example: [‘txr_1234’]
  • coupon (TEXT, Optional): The coupon ID to apply to this subscription
  • promotionCode (TEXT, Optional): The promotion code ID to apply to this subscription

Output: Returns the created subscription details

---

​

Cancel subscription

stripe.cancelsubscription

Cancels a customer’s subscription Requires Confirmation: Yes Parameters:

• subscriptionId (TEXT, Required): The ID of the subscription to cancel
  • cancelAtPeriodEnd (BOOLEAN, Optional): If true, subscription will be canceled at the end of the current period

Output: Returns the canceled subscription details

---

​

Create product

stripe.createproduct

Creates a new product that can be used with prices Requires Confirmation: Yes Parameters:

• name (TEXT, Required): The product’s name, meant to be displayable to the customer
  • description (TEXT, Optional): The product’s description, meant to be displayable to the customer
  • active (BOOLEAN, Optional): Whether the product is currently available for purchase
  • metadata (TEXT, Optional): Set of key-value pairs that you can attach to an object

Output: Returns the created product details

---

​

Create price

stripe.createprice

Creates a new price for a product Requires Confirmation: Yes Parameters:

• productId (TEXT, Required): The ID of the product this price is for
  • unitAmount (NUMBER, Required): The unit amount in the smallest currency unit (e.g., cents)
  • currency (TEXT, Required): Three-letter ISO currency code
  • recurring (TEXT, Optional): The recurring components of a price. Example: interval’: ‘month’, ‘interval_count’: 1}
  • nickname (TEXT, Optional): A brief description of the price, hidden from customers

Output: Returns the created price details

---

​

Create invoice

stripe.createinvoice

Creates a new invoice for a customer Requires Confirmation: Yes Parameters:

• customerId (TEXT, Required): The ID of the customer to invoice
  • description (TEXT, Optional): An arbitrary string attached to the object
  • autoAdvance (BOOLEAN, Optional): Controls whether Stripe will perform automatic collection of the invoice
  • collectionMethod (SELECT, Optional): Either charge_automatically or send_invoice
  • daysUntilDue (NUMBER, Optional): Number of days until the invoice is due (required when collection_method is ‘send_invoice’)

Output: Returns the created invoice details

---

​

Add invoice item

stripe.addinvoiceitem

Add an item to a draft invoice Requires Confirmation: Yes Parameters:

• customerId (TEXT, Required): The ID of the customer (required)
  • invoiceId (TEXT, Optional): The ID of the invoice to add the item to (optional - if not provided, creates a pending invoice item)
  • priceId (TEXT, Optional): The ID of the price object
  • quantity (NUMBER, Optional): The quantity of units for the item
  • amount (NUMBER, Optional): The amount for a one-time charge (in cents)
  • description (TEXT, Optional): Description for the invoice item

Output: Returns the added invoice item details

---

​

Send invoice

stripe.sendinvoice

Sends an invoice to the customer Requires Confirmation: Yes Parameters:

• invoiceId (TEXT, Required): The ID of the invoice to send

Output: Returns the sent invoice details

---

​

Create payment method

stripe.createpaymentmethod

Creates a payment method object representing a customer’s payment instrument Requires Confirmation: Yes Parameters:

• type (SELECT, Required): The type of payment method (us_bank_account, sepa_debit)
  • sepaDebit (TEXT, Optional): SEPA bank account details if type is ‘sepa_debit’. Example: iban’: ‘DE89370400440532013000
  • usBankAccount (TEXT, Optional): US bank account details if type is ‘us_bank_account’. Example: account_number’: ‘000123456789’, ‘routing_number’: ‘110000000’, ‘account_holder_type’: ‘individual
  • billingDetails (TEXT, Optional): Billing information (required for bank accounts). Example: name’: ‘John Doe’, ‘email’: ‘john@example.com’, ‘phone’: ‘+15555555555’, ‘address’: line1’: ‘123 Main St’, ‘city’: ‘San Francisco’, ‘state’: ‘CA’, ‘postal_code’: ‘94111’, ‘country’: ‘US}

Output: Returns the created payment method details

---

​

Attach payment method

stripe.attachpaymentmethod

Attaches a payment method to a customer Requires Confirmation: Yes Parameters:

• paymentMethodId (TEXT, Required): The ID of the payment method to attach
  • customerId (TEXT, Required): The ID of the customer to attach the payment method to

Output: Returns the attached payment method details

---

​

Create charge

stripe.createcharge

Creates a new charge on a payment source Requires Confirmation: Yes Parameters:

• amount (NUMBER, Required): Amount to charge in the smallest currency unit (e.g., cents)
  • currency (TEXT, Required): Three-letter ISO currency code
  • customerId (TEXT, Optional): The ID of the customer to charge
  • source (TEXT, Optional): Payment source to charge (payment method ID or token)
  • description (TEXT, Optional): An arbitrary string attached to the charge

Output: Returns the created charge details

---

​

Create refund

stripe.createrefund

Refunds a charge that has been previously created Requires Confirmation: Yes Parameters:

• chargeId (TEXT, Optional): The ID of the charge to refund
  • paymentIntentId (TEXT, Optional): The ID of the payment intent to refund
  • amount (NUMBER, Optional): Amount to refund in cents. If not provided, the entire charge is refunded
  • reason (SELECT, Optional): Reason for the refund (duplicate, fraudulent, requested_by_customer)

Output: Returns the created refund details

---

​

List charges

stripe.listcharges

Lists all charges with optional filtering Requires Confirmation: No Parameters:

• customerId (TEXT, Optional): Only return charges for this customer
  • limit (NUMBER, Optional): Maximum number of charges to return (1-100)

Output: Returns a list of charges

---

​

List payment intents

stripe.listpaymentintents

Lists all payment intents with optional filtering Requires Confirmation: No Parameters:

• customerId (TEXT, Optional): Only return payment intents for this customer
  • limit (NUMBER, Optional): Maximum number of payment intents to return (1-100)

Output: Returns a list of payment intents

---

​

List subscriptions

stripe.listsubscriptions

Lists all subscriptions with optional filtering Requires Confirmation: No Parameters:

• customerId (TEXT, Optional): Only return subscriptions for this customer
  • status (SELECT, Optional): Only return subscriptions with this status (active, past_due, unpaid, canceled, incomplete, incomplete_expired, trialing)
  • limit (NUMBER, Optional): Maximum number of subscriptions to return (1-100)

Output: Returns a list of subscriptions

---

​

List invoices

stripe.listinvoices

Lists all invoices with optional filtering Requires Confirmation: No Parameters:

• customerId (TEXT, Optional): Only return invoices for this customer
  • status (SELECT, Optional): Only return invoices with this status (draft, open, paid, uncollectible, void)
  • limit (NUMBER, Optional): Maximum number of invoices to return (1-100)

Output: Returns a list of invoices

---

​

Create checkout session

stripe.createcheckoutsession

Creates a Stripe Checkout session for payment collection Requires Confirmation: Yes Parameters:

• successUrl (TEXT, Required): The URL to redirect to after successful payment
  • cancelUrl (TEXT, Required): The URL to redirect to if the customer cancels payment
  • mode (SELECT, Required): The mode of the Checkout Session (payment, subscription, setup)
  • lineItems (TEXT, Optional): List of items the customer is purchasing. Example: [price’: ‘price_1234’, ‘quantity’: 2}]
  • customerId (TEXT, Optional): ID of an existing customer, if one exists

Output: Returns the created checkout session details

---

​

Retrieve balance

stripe.retrievebalance

Retrieves the current account balance Requires Confirmation: No Parameters: None Output: Returns the current account balance

---

​

Get customer funding instructions

stripe.getcustomerfundinginstructions

Retrieves bank transfer funding instructions for a customer’s cash balance in a specific currency Requires Confirmation: No Parameters:

• customerId (TEXT, Required): The ID of the customer to retrieve funding instructions for
  • currency (TEXT, Optional): The currency to retrieve funding instructions for (e.g., eur, usd)

Output: Returns the funding instructions

---

​

List transactions

stripe.listtransactions

Lists all balance transactions Requires Confirmation: No Parameters:

• limit (NUMBER, Optional): Maximum number of transactions to return (1-100)
  • type (TEXT, Optional): Only return transactions of this type

Output: Returns a list of balance transactions

---

​

Create tax rate

stripe.createtaxrate

Creates a new tax rate Requires Confirmation: Yes Parameters:

• displayName (TEXT, Required): The display name of the tax rate (e.g., ‘German VAT’)
  • percentage (NUMBER, Required): The tax rate percentage (e.g., 19 for 19%)
  • inclusive (BOOLEAN, Optional): Whether the tax rate is inclusive (true) or exclusive (false)
  • country (TEXT, Optional): Two-letter country code (e.g., ‘DE’ for Germany)
  • description (TEXT, Optional): Description of the tax rate
  • metadata (TEXT, Optional): Set of key-value pairs that you can attach to an object

Output: Returns the created tax rate details

---

​

Update subscription

stripe.updatesubscription

Updates an existing subscription Requires Confirmation: Yes Parameters:

• subscriptionId (TEXT, Required): The ID of the subscription to update
  • defaultTaxRates (TEXT, Optional): Array of tax rate IDs to apply to the subscription. Example: [‘txr_1234’]
  • items (TEXT, Optional): Array of subscription items to update with tax rates. Example: [id’: ‘si_xxx’, ‘tax_rates’: [‘txr_xxx’]}]
  • trialEnd (TEXT, Optional): Unix timestamp for trial end
  • cancelAtPeriodEnd (BOOLEAN, Optional): Whether to cancel at period end
  • description (TEXT, Optional): Description for the subscription
  • metadata (TEXT, Optional): Set of key-value pairs that you can attach to an object
  • coupon (TEXT, Optional): The coupon ID to apply to this subscription
  • promotionCode (TEXT, Optional): The promotion code ID to apply to this subscription

Output: Returns the updated subscription details

---

​

List tax IDs

stripe.listtaxIDs

Lists all tax IDs for a customer Requires Confirmation: No Parameters:

• customerId (TEXT, Required): The ID of the customer to list tax IDs for

Output: Returns a list of tax IDs for the customer

---

​

Get tax ID

stripe.gettaxID

Retrieves a specific tax ID for a customer Requires Confirmation: No Parameters:

• customerId (TEXT, Required): The ID of the customer
  • taxId (TEXT, Required): The ID of the tax ID to retrieve

Output: Returns the specific tax ID details

---

​

List tax rates

stripe.listtaxrates

Lists all tax rates in your Stripe account Requires Confirmation: No Parameters:

• active (BOOLEAN, Optional): Filter by active status (true/false)
  • limit (NUMBER, Optional): Maximum number of tax rates to return (1-100)

Output: Returns a list of tax rates

---

​

Get invoice

stripe.getinvoice

Retrieves a specific invoice by ID with full details including line items Requires Confirmation: No Parameters:

• invoiceId (TEXT, Required): The ID of the invoice to retrieve (e.g., in_…)

Output: Returns the invoice details with line items

---

​

Get subscription

stripe.getsubscription

Retrieves detailed subscription information including current period, items, and products Requires Confirmation: No Parameters:

• subscriptionId (TEXT, Required): The ID of the subscription to retrieve (e.g., sub_…)

Output: Returns the subscription details

---

​

List overdue invoices

stripe.listoverdueinvoices

Lists all invoices that are past their due date, sorted by days overdue Requires Confirmation: No Parameters:

• customerId (TEXT, Optional): Only return overdue invoices for this customer
  • limit (NUMBER, Optional): Maximum number of overdue invoices to return (1-100)
  • daysOverdue (NUMBER, Optional): Only return invoices that have been overdue for at least this many days

Output: Returns a list of overdue invoices

---

​

Common Use Cases

​

Best Practices

​

Troubleshooting

Issue	Solution
Authentication failed	Verify your API Key credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

​

Support

For additional help with the Stripe integration, contact support@langdock.com